List macros

Active macros with ID, title and description.

GET https://cotlet.dev/api/v1/zendesk/macros

read

Lists the active macros your agent user can apply, shared and personal, with title and description when one exists. Filter by part of the title. Use the macro_id with apply_macro.

Parameters

Parameters: list_macros
NameTypeDescription
query string string Only macros whose title contains this text.
limit integer integer 1 to 100. Default: 50.

Request

cURL
curl https://cotlet.dev/api/v1/zendesk/macros \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("zendesk", "list_macros")
Node.js
const result = await cotlet.call('zendesk', 'list_macros');
CLI
cotlet call zendesk list_macros

Example response

JSON

{
  "macros": [
    {
      "macro_id": 360011204873,
      "title": "Downgrade and inform",
      "description": "Sets priority to low and tells the requester about possible delay."
    },
    {
      "macro_id": 360011204912,
      "title": "Requester not responding",
      "description": "Reminder for a pending ticket where the requester has not answered."
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.