API Reference/Endpoints

Retrieve an account

GET/api/linkedin/gateway/accounts/{account_id}

Reads back everything Warmably holds for one connected account — its display name, when it was linked, and whether its underlying connection is currently healthy.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401. The account_id path segment doubles as the gateway's ownership check — see Resolving account_id on the direct API access page.

Path parameters

FieldTypeDescription

account_id *stringA connected account's id. Must belong to this key.

Response fields

FieldTypeDescription

idstringEchoes account_id.

namestringThe label given to this account when it was connected.

typestringThe connected channel — LINKEDIN for accounts created through Warmably.

created_atstringISO 8601 timestamp of when the account was first linked.

sourcesarrayOne entry per underlying data source, each with a status of OK, STOPPED, ERROR, CREDENTIALS, PERMISSIONS or CONNECTING.

groupsarrayIds of any account groups this account belongs to.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.·404 Not Found. No account with that id exists upstream.