List Instagram automations
const url = 'https://app.whatsetter.com/api/v1/instagram/automations';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://app.whatsetter.com/api/v1/instagram/automations \ --header 'Authorization: Bearer <token>'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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”One Instagram account of the workspace (all of them by default).
Responses
Section titled “Responses”The automations
object
object
object
What fires it. Read back, ref_link is an automation made in the dashboard on an ig.me link.
One of these words fires it (accents and case ignored).
Every comment or message fires it
object
object
The agent that continues (its campaign_id).
object
Times it fired
Private messages it sent.
People who opened its link (once per person).
Example
{ "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" } ]}Missing, unknown or revoked API key
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}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)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Resource not found in this workspace
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}