curl --request GET \
--url 'https://api-prod.usefini.com/v2/macros/public?search=Documents' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/macros/public?search=Documents', {
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/public?search=Documents",
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
List macros
List saved replies in your workspace, optionally searching by title.
GET
/
v2
/
macros
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/macros/public?search=Documents' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/macros/public?search=Documents', {
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/public?search=Documents",
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"
}
]
List saved replies in your workspace, optionally searching by title. See the Macros overview for the shared object and scope model.
Results are ordered by title, ascending. The endpoint returns an array directly, not a paginated envelope.
Headers
string
required
Bearer token containing your workspace API key. The key needs
read scope.Query parameters
string
Case-insensitive title search, up to 150 characters after trimming. Omit or leave blank to list all macros. Search uses substring matching;
% and _ act as SQL LIKE wildcards. Message bodies are not searched.Response
Returns an array of macro objects. Examples use synthetic IDs and timestamps.curl --request GET \
--url 'https://api-prod.usefini.com/v2/macros/public?search=Documents' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/macros/public?search=Documents', {
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/public?search=Documents",
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.
Was this page helpful?