Check account health

An end-to-end check of one account: whether Instagram has paused the connection and why, how fast it sends and how much is waiting, which errors Instagram has returned lately, and whether any live automation is set up in a way that can’t fire. The answer to “why did nobody get the DM?”.

A queue is not a fault. inDM spaces sends on purpose so Instagram keeps trusting the account; messages_waiting drains at send_speed_per_hour.

Needs a read or full key.

GET /accounts/{account_id}/health

Check account health

cURL

curl --request GET \
  --url https://api.indm.social/v1/accounts/{account_id}/health \
  --header 'Authorization: Bearer <token>'

200

{
  "account_id": "6f1c2a9e-3b7d-4e21-9a55-0c8d2f4b7e10",
  "username": "maya.grows",
  "status": "connected",
  "live_automations": 2,
  "automations_that_cannot_fire": [],
  "send_speed_per_hour": 200,
  "messages_waiting": 4,
  "messages_failed_last_24h": 0,
  "messages_failed_last_7d": 1,
  "instagram_errors_last_7d": {
    "Instagram refused to message specific people": 1
  },
  "reason": "token_expired",
  "dark_since": "2023-11-07T05:31:56Z",
  "last_inbound_received_at": "2026-11-05T08:52:40Z"
}

Authorizations

Authorization · string · header · required

An API key from Settings → API keys in the inDM app, sent as Authorization: Bearer indm_.... Keys belong to one workspace and carry a scope: read for GET routes and the validate dry run, full for everything. Keep keys on your server; never ship one to a browser or a mobile app.

Path Parameters

account_id · string<uuid> · required

The account id from List accounts.

Response

200

application/json

The account's health.

account_id · string<uuid> · required

Example:

"6f1c2a9e-3b7d-4e21-9a55-0c8d2f4b7e10"

username · string · required

The Instagram handle, without the @.

Example:

"maya.grows"

status · enum<string> · required

connected when everything is running. needs_reconnect when Instagram has paused the connection; nothing syncs or sends until it is reconnected in the app.

Available options: connected, needs_reconnect, disconnected, error

Example:

"connected"

live_automations · integer · required

Automations live on this account now.

Example:

2

automations_that_cannot_fire · string[] · required

Names of live automations set up in a way that can never trigger, such as one with no keywords. Empty when there are none.

Example:

[]

send_speed_per_hour · integer · required

How many messages this account sends per hour, at most. inDM spaces sends on purpose so Instagram keeps trusting the account.

Example:

200

messages_waiting · integer · required

Messages queued for this account right now. A queue drains at send_speed_per_hour; it is not a fault.

Example:

4

messages_failed_last_24h · integer · required

Messages Instagram refused in the last 24 hours.

Example:

0

messages_failed_last_7d · integer · required

Messages Instagram refused in the last 7 days. The true total for the window instagram_errors_last_7d breaks down.

Example:

1

instagram_errors_last_7d · object · required

What Instagram refused in the last 7 days and how often, keyed by a plain-words summary of each refusal. The keys are written for people, so show them rather than branching on them. Read the total from messages_failed_last_7d. Empty when nothing was refused.

Show child attributes

Example:

{
  "Instagram refused to message specific people": 1
}

reason · string

A stable slug for why the account isn't connected. Present only when it isn't.

Example:

"token_expired"

dark_since · string<date-time>

When the account stopped working. Present only when it has.

last_inbound_received_at · string<date-time>

When inDM last heard from Instagram about a comment or message on this account. A long silence on an active account is worth a look.

Example:

"2026-11-05T08:52:40Z"