🚫Call Personalisation (Bulk)

Async API to send call personalisation data for a Caller-Receiver combination

Replace the {{BaseURL}} with the one mentioned here

POST {{BaseURL}}/clients/{clientAccountId}/dynamic_call_records

{clientAccountId} : This can be taken directly from the self serve portal under the Manage API Keys Page

Headers

Name	Value
Content-Type	Required application/json
Authorization	Required Bearer <token>

Body

Name	Type	Validations	Description
call_records	object	(how many call records are supported in a single api call?)	Call Record object
call_reason	string	minLength: 3 maxLength: 10	Optional The call reason to be displayed.
caller	string	Format Supported:"91**********" Caller number should be without the “+” character.	Required The phone no. of the caller
ends_at	integer (int64)	NA	Required The timestamp in milliseconds at which dynamic caller ID should expire. Should not be before the current timestamp. starts_at and ends_at cannot be more than 24 hrs apart
label_id	string	NA	Optional The label ID of the dynamic label to be used as caller id
label_name	string	minLength: 3 maxLength: 40	Required The caller ID name to be displayed. If not present it will default to the label name of the label ID provided.
receiver	string	Format Supported:"91**********" Receiver number should be without the “+” character.	Required The phone no. of the receiver
starts_at	integer (int64)	NA	Required The timestamp in milliseconds at which dynamic caller ID should start reflecting. starts_at and ends_at cannot be more than 24 hrs apart

Request

JSON

{
    "call_records": [
        {
            "call_reason": "Flower Delivery",
            "caller": "**********",
            "ends_at": 2,
            "label_id": "255297eb-7f13-44f9-967a-f287ff0f5025",
            "label_name": "Flower",
            "receiver": "**********",
            "starts_at": 1
        }
    ]
}

Response

201 Created

{
    "status": "success",
    "message": "Records Uploaded Successfully. BatchID: 6dabe53b-14a5-44bf-9bab-3dda8b0fee54"
}

201 Created

{
    "status": "failure",
    "message": "ends_at cannot be older than current time. BatchID: d30ca8f7-ae64-4c30-8700-d63f6b2f1dd6"
}

401 Unauthorised

{
    "slug": "authorization-error",
    "message": "please login again"
}

API Rate Limits

• Truecaller for Business restricts API requests when you exceed the limits entitled to your business.

• Each token can handle 100 requests per second

• Maximum of 10 tokens can be created in every 30 minutes