Skip to main content
GET
/
automations
/
:id
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/automations/auto_9xKp2Lm4nQ
{
  "status": "success",
  "id": "auto_9xKp2Lm4nQ",
  "platform": "instagram",
  "accountId": "17841400000000000",
  "name": "Spring promo",
  "description": "",
  "active": true,
  "stats": {
    "totalSent": 42,
    "totalFailed": 1,
    "lastTriggeredAt": "2026-05-12T09:14:22.000Z",
    "lastSentAt": "2026-05-12T09:14:48.000Z"
  },
  "created": "2026-04-30T12:00:00.000Z",
  "updated": "2026-05-12T09:14:48.000Z",
  "triggers": [
    {
      "id": "trg_a1b2c3",
      "type": "comment_keyword",
      "active": true,
      "config": {
        "postId": "17895695668004550",
        "keywords": ["INFO", "LINK"]
      }
    }
  ],
  "actions": [
    {
      "id": "act_d4e5f6",
      "type": "send_dm",
      "active": true,
      "config": {
        "message": "Hey {{recipient_username}}, here is the link you wanted: https://example.com"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Beta. See the Automations Overview for the full feature description.
Returns one automation including every attached trigger and action. Soft-deleted automations return 469 so an attacker probing for IDs gets the same response as a legitimate “not found”.

Header Parameters

Path Parameters

id
string
required
The automation ID returned from POST /automations.
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/automations/auto_9xKp2Lm4nQ
{
  "status": "success",
  "id": "auto_9xKp2Lm4nQ",
  "platform": "instagram",
  "accountId": "17841400000000000",
  "name": "Spring promo",
  "description": "",
  "active": true,
  "stats": {
    "totalSent": 42,
    "totalFailed": 1,
    "lastTriggeredAt": "2026-05-12T09:14:22.000Z",
    "lastSentAt": "2026-05-12T09:14:48.000Z"
  },
  "created": "2026-04-30T12:00:00.000Z",
  "updated": "2026-05-12T09:14:48.000Z",
  "triggers": [
    {
      "id": "trg_a1b2c3",
      "type": "comment_keyword",
      "active": true,
      "config": {
        "postId": "17895695668004550",
        "keywords": ["INFO", "LINK"]
      }
    }
  ],
  "actions": [
    {
      "id": "act_d4e5f6",
      "type": "send_dm",
      "active": true,
      "config": {
        "message": "Hey {{recipient_username}}, here is the link you wanted: https://example.com"
      }
    }
  ]
}