Add Contacts To Contact List

POST

https://apicfa.convirza.com/v2/contact-lists/{id}/contacts

SMS Broadcast

Last modified:2026-04-03 12:54:09

Add multiple contact numbers to an existing contact list with validation for duplicates

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Contact numbers added successfully

Headers

Body

🟠400

🟠401

🟠403

🟠404

🔴500

⚪default

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://apicfa.convirza.com/v2/contact-lists//contacts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "numbers": [
        {
            "contact_name": "John",
            "country_code": "+1",
            "phone_number": "1234567890"
        }
    ],
    "status": "active"
}'

Response Example

200 - Example 1

{
    "status": "success",
    "message": "Contact numbers added successfully",
    "inserted": 5,
    "duplicates": [
        {
            "country_code": "string",
            "phone_number": 0
        }
    ]
}

Modified at 2026-04-03 12:54:09

List Contacts in Contact List

Update Contact in Contact List