whatsapp
List contacts
List WhatsApp contacts for an account. Supports filtering by tags, groups, opt-in status, and text search. Returns contacts sorted by name with available filter options.
AuthorizationBearer <token>
API key authentication - use your Late API key as a Bearer token
In: header
Query Parameters
accountIdstring
WhatsApp social account ID
search?string
Search contacts by name, phone, email, or company
tag?string
Filter by tag
group?string
Filter by group
optedIn?string
Filter by opt-in status
Value in
"true" | "false"limit?integer
Maximum results (default 50)
Default
50skip?integer
Offset for pagination
Default
0Response Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/whatsapp/contacts?accountId=string"{
"success": true,
"contacts": [
{
"id": "string",
"phone": "string",
"waId": "string",
"name": "string",
"email": "string",
"company": "string",
"tags": [
"string"
],
"groups": [
"string"
],
"isOptedIn": true,
"lastMessageSentAt": "2019-08-24T14:15:22Z",
"lastMessageReceivedAt": "2019-08-24T14:15:22Z",
"messagesSentCount": 0,
"messagesReceivedCount": 0,
"customFields": {},
"notes": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
],
"filters": {
"tags": [
"string"
],
"groups": [
"string"
]
},
"pagination": {
"total": 0,
"limit": 0,
"skip": 0,
"hasMore": true
}
}Empty
{
"error": "Unauthorized"
}Empty