# List Instagram automations

`GET https://app.whatsetter.com/api/v1/instagram/automations`

The workspace's Instagram automations (the dashboard's
« Automatisations »), each with what fires it, what it answers, the
agent that continues, whether it is `active`, and its numbers
(`stats`: times it fired, private messages sent, links opened, last
time it fired). `trigger.on` is `ref_link` for an automation made in
the dashboard on an ig.me link. Requires scope `instagram:read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `account_id` | query | string | no | One Instagram account of the workspace (all of them by default). |

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/instagram/automations' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The automations

```json
{
  "data": [
    {
      "id": "6900a1b2c3d4e5f6a7b8c9d0",
      "account_id": "68f1c2d3e4f5a6b7c8d9e0f1",
      "name": "Buyer's guide",
      "active": true,
      "trigger": {
        "on": "comment",
        "posts": "next",
        "keywords": [
          "GUIDE"
        ],
        "any_word": false
      },
      "public_replies": [
        "Sent you a DM 👀"
      ],
      "dm_message": "Here is the guide 👇",
      "link": {
        "url": "https://example.com/guide",
        "label": "Get the guide",
        "ask_label": null,
        "title": null
      },
      "follow_gate": null,
      "campaign_id": "instagram-acme-studio-x7k2",
      "ai_handoff": true,
      "stats": {
        "fired": 240,
        "dms_sent": 231,
        "link_clicks": 88,
        "last_fired_at": "2026-10-30T16:12:09.000Z"
      },
      "created_at": "2026-10-20T09:00:00.000Z"
    }
  ]
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listinstagramautomations/
