whatsapp
Bulk import contacts
Import up to 1000 contacts at once. Each contact requires a phone number and name. Duplicates are skipped by default. Supports default tags and groups applied to all imported contacts.
AuthorizationBearer <token>
API key authentication - use your Late API key as a Bearer token
In: header
accountIdstring
WhatsApp social account ID
contacts
Contacts to import (max 1000)
Items
items <= 1000defaultTags?array<string>
Tags applied to all imported contacts
defaultGroups?array<string>
Groups applied to all imported contacts
skipDuplicates?boolean
Skip contacts with existing phone numbers
Default
trueResponse Body
application/json
application/json
curl -X POST "https://getlate.dev/api/v1/whatsapp/contacts/import" \ -H "Content-Type: application/json" \ -d '{ "accountId": "507f1f77bcf86cd799439011", "contacts": [ { "phone": "+1234567890", "name": "John Doe", "email": "john@example.com" }, { "phone": "+0987654321", "name": "Jane Smith" } ], "defaultTags": [ "imported" ], "defaultGroups": [ "new-leads" ] }'{
"success": true,
"summary": {
"total": 0,
"created": 0,
"skipped": 0,
"failed": 0
},
"results": [
{
"phone": "string",
"name": "string",
"success": true,
"contactId": "string",
"error": "string"
}
]
}Empty
{
"error": "Unauthorized"
}Empty