curl --request GET \
--url 'https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public', {
method: 'GET',
headers: {"Authorization": "Bearer fini_your_api_key"}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
data = response.json()
{
"id": "e73b7a87-6eaf-4e77-8d04-5a3f29a52f60",
"companyId": "97c8757b-83be-45aa-9f29-749d03f873fb",
"title": "Documents sent",
"body": "Hi {{attributes.firstName}}, your requested documents are ready.",
"createdBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"updatedBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"createdAt": "2026-10-08T08:00:00.000Z",
"updatedAt": "2026-10-08T08:00:00.000Z"
}
Macros
Get macro
Read a saved reply in your workspace.
GET
/
v2
/
macros
/
{id}
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public', {
method: 'GET',
headers: {"Authorization": "Bearer fini_your_api_key"}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
data = response.json()
{
"id": "e73b7a87-6eaf-4e77-8d04-5a3f29a52f60",
"companyId": "97c8757b-83be-45aa-9f29-749d03f873fb",
"title": "Documents sent",
"body": "Hi {{attributes.firstName}}, your requested documents are ready.",
"createdBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"updatedBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"createdAt": "2026-10-08T08:00:00.000Z",
"updatedAt": "2026-10-08T08:00:00.000Z"
}
Read a saved reply in your workspace. See the Macros overview for the shared object and scope model.
Headers
string
required
Bearer token containing your workspace API key. The key needs
read scope.Path parameters
string
required
Macro UUID belonging to the authenticated workspace.
Response
Returns the macro object. Examples use synthetic IDs and timestamps.curl --request GET \
--url 'https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public', {
method: 'GET',
headers: {"Authorization": "Bearer fini_your_api_key"}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/macros/e73b7a87-6eaf-4e77-8d04-5a3f29a52f60/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
data = response.json()
{
"id": "e73b7a87-6eaf-4e77-8d04-5a3f29a52f60",
"companyId": "97c8757b-83be-45aa-9f29-749d03f873fb",
"title": "Documents sent",
"body": "Hi {{attributes.firstName}}, your requested documents are ready.",
"createdBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"updatedBy": "a5dc0132-4998-4be2-a821-910881658bcb",
"createdAt": "2026-10-08T08:00:00.000Z",
"updatedAt": "2026-10-08T08:00:00.000Z"
}
Errors
400: Invalid parameters or failed field validation.401: Missing or invalid credential.403: Credential lacks the required scope.406: No workspace is associated with the authenticated user.404: Macro not found in this workspace.
Was this page helpful?