WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

List invitations received

GET/api/linkedin/gateway/users/invite/received

Pages through connection requests sent to the connected account that it hasn't yet acted on. Each item carries a shared_secret token that's required to accept or decline it.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401. The account behind account_id must belong to your key.

Query parameters

FieldTypeDescription
account_id *stringWhich connected account's received invitations to list.
limitintegerItems per page, 1–100. Defaults to 10.
cursorstringThe cursor from a previous response, to continue paging.

Response fields

FieldTypeDescription
resultobjectitems[], each with the invitation's id, the sender's name and identifiers, invitation_text, an inviter block, and a specifics block carrying shared_secret — keep that value for Accept or decline an invitation — plus a paging cursor.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl "https://api.warmably.com/api/linkedin/gateway/users/invite/received?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "object": "InvitationList",
  "items": [
    {
      "object": "InvitationReceived",
      "id": "9a4c2e11-5f0b-4d3a-8e77-1b2c3d4e5f60",
      "invited_user": "Jane Doe",
      "invited_user_id": "ACoAAABpbnZpdGVy",
      "invited_user_public_id": "jane-doe-mkt",
      "invited_user_description": "Growth Marketing Lead at Acme",
      "date": "1d",
      "parsed_datetime": "2026-09-02T14:03:00Z",
      "invitation_text": "Would love to connect after your talk!",
      "inviter": {
        "inviter_name": "Devon Park",
        "inviter_id": "ACoAAABmb2xsb3dlcg",
        "inviter_public_identifier": "devon-park",
        "inviter_description": "Product Marketing at Slate"
      },
      "specifics": {
        "provider": "LINKEDIN",
        "shared_secret": "eyJhbGciOiJIUzI1NiJ9..."
      }
    }
  ],
  "cursor": null
}
No key yet? Create one from Dashboard → API Keys.