Skip to content
Home/
REST API Reference
/
/
List all macros

List all macros

Request

You can fetch a list of all macros (saved replies) in your workspace for use in automating responses.

The macros are returned in descending order by updated_at.

Pagination

This endpoint uses cursor-based pagination via the starting_after parameter. The cursor is a Base64-encoded JSON array containing [updated_at, id] of the last item from the previous page.

Placeholder Transformation

The API transforms Intercom placeholders to a more standard XML-like format:

  • From: {{user.name | fallback: 'there'}}
  • To: <attribute key="user.name" default="there"/>
Security
bearerAuth
Query
per_pageinteger, [ 1 .. 150 ]

The number of results per page

Default:50
Example:per_page=50
starting_afterstring

Base64-encoded cursor containing [updated_at, id] for pagination

Example:starting_after=WzE3MTk0OTM3NTcuMCwgIjEyMyJd
updated_sinceinteger, (int64)

Unix timestamp to filter macros updated after this time

Example:updated_since=1719474966
Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"2.16"
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:2.16
curl -i -X GET \
  'https://api.intercom.io/macros?per_page=50&starting_after=WzE3MTk0OTM3NTcuMCwgIjEyMyJd&updated_since=1719474966' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.16'

Responses

Successful response

Bodyapplication/json
typestring

Always list

Value:"list"
Example:"list"
dataArray of objects(Macro)

The list of macro objects

pagesobject

Pagination information

Response
{
  "type": "list",
  "data": [
    { … },
    { … }
  ],
  "pages": {
    "type": "pages",
    "per_page": 50,
    "next": { … }
  }
}