Skip to main content

Create a new contact

POST 
/api/partner-gateway/v1/contacts

Creates a new individual contact in your account. You must provide at least a phone number or an email address. The phone number should be in E.164 international format (e.g., +393331234567). You can include optional fields such as firstName, lastName, gender, and any custom fields your account has configured. After creating a contact, you can assign it to one or more contact lists using POST /contacts/list/contacts so it becomes a recipient in campaigns. For bulk imports, use POST /contacts/upload (CSV/Excel) or POST /contacts/upload/vcard (VCF) instead of creating contacts one by one. Returns 201 with the created contact details including the generated contact ID. Returns 400 if the request body is missing required fields or contains invalid data (e.g., malformed phone number). Returns 500 if an unexpected server error occurs.

Request​

Responses​

Contact created successfully

Last updated on