Add contacts to a group
POST/api/v1/contacts/groups/:groupId/contacts
Feeds a group. The body carries a contacts array, not a bare list of numbers.
phonemust contain digits only — no+, no space, no dash. Write221771234567, not+221 77 123 45 67.- 1000 entries maximum per request. For larger volumes call this endpoint several times on the same group: contacts accumulate.
- Sending a number already in the group does not duplicate it — its
nameandnotesare updated instead.
Required capability: CAMPAIGNS
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
Contacts processed.
Empty list, more than 1000 entries, or a phone that is not digits only.
Missing or invalid API key.
A capability required by this endpoint is not enabled on your account. Ask your account manager to switch it on.
Not found, or not owned by your account.
Too many requests. Back off and retry.