Update PSTN Number Mappings

Sets, for many PSTN numbers in one request, which WhatsApp number each one is linked to and who answers its incoming calls: a team member or an AI agent. It does the same as editing a PSTN channel in the app (Channels → PSTN number → Edit channel details), for up to 500 numbers at a time.

Endpoint

POST https://public.doubletick.io/v1/call/pstn-mappings

Authentication

Pass your API key in the Authorization header.

The API key's user needs permission to add channels, the same permission needed to edit a PSTN channel in the app.

📘

NOTE

If you do not have your DoubleTick API Key, you can obtain it by following this guide link.

Request Body

Mapping Object

🚧

Routing

Send at most one of agentNumber and aiAgentName in a mapping. If you send neither, only the linked WhatsApp number changes and the number keeps the incoming call routing it already has.

All phone numbers take the country code, with or without the leading +, 7 to 15 digits (e.g. +919876543210 or 919876543210).

Example Request

curl --request POST \
  --url https://public.doubletick.io/v1/call/pstn-mappings \
  --header 'Authorization: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "mappings": [
      {
        "pstnNumber": "+911234567890",
        "whatsappNumber": "+919000000001",
        "agentNumber": "+919812345678"
      },
      {
        "pstnNumber": "+911234567891",
        "whatsappNumber": "+919000000001",
        "aiAgentName": "Sales Agent"
      },
      {
        "pstnNumber": "+911234567892",
        "whatsappNumber": "+919000000002"
      }
    ]
  }'

Example Response

{
  "total": 3,
  "updated": 1,
  "unchanged": 1,
  "failed": 1,
  "results": [
    {
      "index": 0,
      "pstnNumber": "+911234567890",
      "status": "UPDATED"
    },
    {
      "index": 1,
      "pstnNumber": "+911234567891",
      "status": "UNCHANGED"
    },
    {
      "index": 2,
      "pstnNumber": "+911234567892",
      "status": "FAILED",
      "code": "WHATSAPP_NUMBER_NOT_FOUND",
      "message": "This WhatsApp number is not connected in your organization"
    }
  ]
}

📘

NOTE

A 200 means the request was read, even when some or all mappings failed. Check the counts and results to see what happened to each mapping.

Response Fields

Mapping Error Codes

These come back inside results for a mapping that failed. The other mappings in the request are still saved.

Error Responses

Things to Know

• Up to 500 mappings per request. Split a longer list into several requests.
• Each mapping is checked on its own. A failed mapping does not stop the others, and nothing is written for a failed mapping.
• Sending the same request again is safe: mappings already in place come back UNCHANGED, so you only need to fix and resend the failed ones.
• If you send neither agentNumber nor aiAgentName, the number's incoming call routing is kept as it is. This API never clears it.
• agentNumber must match exactly one active member of your organization by phone number, and the member must have access to the PSTN number.
• aiAgentName must match the AI agent's name exactly.
• Changes apply from the next incoming call. Nothing needs to be restarted.
• This endpoint only changes mappings. To place calls, use Initiate Agent Call or Initiate AI Bot Call.