WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

List email contacts

GET/api/linkedin/gateway/emails/contacts

Lists the address-book contacts stored against a connected mailbox — names, emails, phone numbers and addresses, where the provider tracks them.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Query parameters

FieldTypeDescription
account_id *stringThe connected account whose contacts to list.
limitnumberPage size, 1–250.
cursorstringPagination cursor from a previous page's response.
This endpoint only works for Gmail (Google OAuth) and Outlook accounts — other providers don't expose a contacts list.

Response fields

FieldTypeDescription
object"EmailContactList"Always this value.
itemsarrayEach contact: id, given_name, emails, phone_numbers, physical_addresses, web_pages and groups.
cursorstring | nullPass to a follow-up call to fetch the next page; null once exhausted.

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/emails/contacts?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf&limit=50" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "object": "EmailContactList",
  "items": [
    {
      "object": "contact",
      "id": "c_71a2f0",
      "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
      "given_name": "Priya Shah",
      "emails": [{ "email": "priya@example.com", "type": "work" }],
      "phone_numbers": [],
      "physical_addresses": [],
      "web_pages": [],
      "groups": []
    }
  ],
  "cursor": null
}
No key yet? Create one from Dashboard → API Keys.