Skip to main content
GET
/
api
/
automations
/
{id}
Get a specific automation by ID
curl --request GET \
  --url https://your-instance.example.com/api/automations/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "_id": "64d2f9c5e8a1d4e001a0b1c2",
    "name": "Follow-up after 24h",
    "description": "Send a follow-up SMS if the lead has not replied in 24h.",
    "triggerLogicType": "timer",
    "enabled": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Response

Automation returned

​
success
enum<boolean>
required
Available options:
true
​
data
object
required

An Automation document with two derived per-user fields: enabled (from User.automations[id]) and userSmsNotification (per-user SMS settings).

Example:
{
  "_id": "64d2f9c5e8a1d4e001a0b1c2",
  "name": "Follow-up after 24h",
  "description": "Send a follow-up SMS if the lead has not replied in 24h.",
  "organizationId": "64a1b2c3d4e5f60012345678",
  "userId": "64a1b2c3d4e5f60012345679",
  "event": "message.received",
  "actions": {
    "sendMessage": [
      {
        "template": "follow-up-24h",
        "channel": "sms"
      }
    ]
  },
  "sourceStatuses": ["New lead"],
  "maxTransitions": 3,
  "triggerType": "status_change",
  "conditions": [
    {
      "field": "lastInboundDirection",
      "op": "eq",
      "value": "inbound"
    }
  ],
  "triggerLogicType": "timer",
  "timerLogic": {
    "enabled": true,
    "delay": 24,
    "unit": "hours"
  },
  "schedule": { "start": "09:00", "end": "18:00" },
  "maxFollowUpCount": 3,
  "enabled": true,
  "userSmsNotification": {
    "enabled": true,
    "phoneNumbers": ["+14155551234"],
    "message": "New lead pending follow-up."
  },
  "createdAt": "2026-04-12T14:22:10.000Z",
  "updatedAt": "2026-04-22T10:14:00.000Z"
}