🚫Call Personalisation Real-time API

Sync API to send call personalisation data for a Caller-Receiver combination. This is a real-time API

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

POST {{BaseURL}}/clients/{clientAccountId}/dynamic_call_record

{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_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_reason": "Flower Delivery",
  "caller": "91**********",
  "ends_at":1751886000000,
  "label_id": "255297eb-7f13-44f9-967a-f287ff0f5025",
  "label_name": "Delivery",
  "receiver": "91**********",
  "starts_at": 1751879424883
}

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": "Missing authorization header"
}

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