# Add contacts bulk

Add new contacts in bulk. When a given phone number already exists, it updates existing contact.

# Method

POST

# Path

/contact/bulk

# Body parameters

Name Value Data type Required?
list_id 0 - to add to "All Contacts" or
List ID - to add to a contact list (List ID is the value shown in the address bar when a list is selected on the Contacts page)
Integer No (defaults to 0)
phone_number_cc Phone number country dial code (e.g. "1") String No
records Array of up to 10,000 contacts { phone_number: [phone number starting with country code (required)], name: [contact name (optional)] } Array Yes

# Response

# HTTP status codes

Code Description
200 Request was successful.
400 Validation error or request body was incorrectly formatted.
401 Authentication failed. Check apikey header.
404 Requested API endpoint not found.
429 The rate limit has been reached.
500-511 There was a problem processing the request on our server. Try again later.

# Response object

Name Value Description
status success or error -
errors Array of object { msg: [error detail] } Only present when status is error

# Code sample

curl --location --request POST 'https://api.sociocs.com/contact/bulk' \
--header 'apikey: [your api key]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "list_id": 0,
    "phone_number_cc": "1",
    "records": [
        {
            "phone_number": "16175551212",
            "name": "John Johnson"
        },
        {
            "phone_number": "16175551111",
            "name": "David Davidson"
        }
    ]
}'