Documentation menu

Get connection session

Poll a connection session until it completes, fails, or expires.

GEThttps://app.tryadeli.com/api/v1/profiles/{profileId}/connect/{connectionSessionId}

AuthorizationBearer <API key>How keys work

Request

curl --fail-with-body "https://app.tryadeli.com/api/v1/profiles/00000000-0000-4000-8000-000000000001/connect/00000000-0000-4000-8000-000000000002" \
  -H "Authorization: Bearer $ADELI_API_KEY"

Response

{
  "id": "00000000-0000-4000-8000-000000000002",
  "profileId": "00000000-0000-4000-8000-000000000001",
  "platform": "instagram",
  "authMethod": "instagram_login",
  "status": "connected",
  "accountId": "00000000-0000-0000-0000-000000000000",
  "expiresAt": "2026-09-08T20:10:00.000Z",
  "completedAt": "2026-09-08T20:03:11.000Z",
  "error": null
}

The same object without authUrl. Poll until status is terminal.

Session status

pending_authorization: Waiting for your customer to authorize. Becomes expired ten minutes after creation.
processing: The customer authorized and Adeli is exchanging the code with the provider. This is brief, and may finish after expiresAt has passed.
connectedterminal: Done. accountId is the connection to use in every later request.
failedterminal: Authorization was denied or the exchange failed. error.code says why.
expiredterminal: Nobody completed authorization in time. Start a new session.

Errors — 401 unauthorized, 400 invalid_request, 404 profile_not_found, 404 connection_session_not_found, 502 database_error.