Home//Macros
Macros
Introduction
Changelog (2.18)
Intercom API
Admins
AI Content
Articles
Audiences
Auth Tokens
Away Status Reasons
Banners
Brands
Calls
Companies
Contacts
Content
Content Snippets
Conversations
Conversations Attributes
Custom Object Instances
Data Attributes
Data Connectors
Data Events
Data Export
Ecommerce Connectors
Dynamic Content
Emails
Fin Agent
Folders
Help Center
Internal Articles
IP Allowlist
Jobs
Messages
News
Notes
Office Hours
Reporting Data Export
Roles
Segments
Subscription Types
Switch
Tags
Teams
Ticket States
Ticket Type Attributes
Ticket Types
Tickets
Visitors
WhatsApp
Workflows
Models
A macro is a pre-defined response template (saved reply) that can be used to quickly reply to conversations.
String representing the object's type. Always has the value macro.
Value:"macro"
Example:"macro"
The body of the macro in HTML format with placeholders transformed to XML-like format.
Example:"<p>Hi <attribute key=\"user.name\" default=\"there\"/>, your order is ready!</p>"
The plain text version of the macro body with original Intercom placeholder format.
Example:"Hi {{user.name|fallback:\"there\"}}, your order is ready!"
The time the macro was created in ISO 8601 format.
Example:"2025-07-17T11:18:08.000Z"
The time the macro was last updated in ISO 8601 format.
Example:"2025-07-17T15:30:24.000Z"
The team IDs that can view this macro when visible_to is set to specific_teams.
Example:
[ "456", "789" ]
{ "type": "macro", "id": "123", "name": "Order Status Update", "body": "<p>Hi <attribute key=\"user.name\" default=\"there\"/>, your order is ready!</p>", "body_text": "Hi {{user.name|fallback:\"there\"}}, your order is ready!", "created_at": "2025-07-17T11:18:08.000Z", "updated_at": "2025-07-17T15:30:24.000Z", "visible_to": "everyone", "visible_to_team_ids": [ "456", "789" ], "available_on": [ "inbox", "messenger" ] }