Upload contacts

POST

/api/partners/contacts/upload

INFO

This endpoint is only available to selected data partners (e.g. caller id apps), schedule a meeting, in return we will provide the spam protection API for free

Upload contacts to CallerAPI database

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://callerapi.com/api/partners/contacts/upload' \
--header 'Content-Type: application/json' \
--header 'x-auth;' \
--data-raw '{
    "external_user_id": "user_12345",
    "external_user_phone": "+14155550123",
    "contacts": [
        {
            "phone_number": "+12125551234",
            "name": "Alice Example",
            "email": "alice@example.com"
        },
        {
            "phone_number": "+14155559876",
            "name": "Bob Example"
        }
    ]
}'

Response Example

200 - Successful upload

{
    "failed": 0,
    "inserted": 2,
    "status": "success"
}

Request

Authorization

API Key

Add parameter in header

x-auth

Example:

x-auth: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

Modified at 2025-08-13 23:17:44

Upload spam reports

Coming soon...