Skip to main content
GET
Get an account

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

The account.

id
string<uuid>
required

The account id the other endpoints take.

Example:

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

workspace_id
string<uuid>
required
Example:

"2c5e8a1b-7f3d-4c9e-b0a2-5d6e7f8a9b0c"

username
string
required

The Instagram handle, without the @.

Example:

"maya.grows"

followers
integer
required

Follower count at the last sync.

Example:

48200

status
enum<string>
required

connected when everything is running. needs_reconnect when Instagram has paused the connection and the creator needs to reconnect in the app; nothing syncs or sends until then.

Available options:
connected,
needs_reconnect,
disconnected,
error
Example:

"connected"

reason
string

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

Example:

"token_expired"

status_changed_at
string<date-time>

When status last changed. Present only when it isn't connected.

last_synced_at
string<date-time>

When inDM last pulled posts from Instagram.

Example:

"2026-11-05T08:41:12Z"