Rejoin a Call
Get new credentials after the team member's connection dropped.
Gives new credentials after the team member's connection dropped, for example after a network change or a page reload. Call it within 60 seconds of the drop; until then the customer stays on the line.
Endpoint
POST https://public.doubletick.io/v1/call/person/{callId}/reconnect
Authentication
Include your API key in the Authorization header.
| Header | Value |
|---|---|
| Authorization | <your-api-key> |
| Content-Type | application/json |
NOTE
If you do not have your DoubleTick API Key, you can obtain it by following this guide link.
Request Body
| Field | Required | Notes |
|---|---|---|
agentNumber | yes | The team member, by the phone number on their DoubleTick profile. |
Example Request
curl -X POST https://public.doubletick.io/v1/call/person/{callId}/reconnect \
-H 'Authorization: <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{ "agentNumber": "<team member number>" }'
Example Response
{
"success": true,
"message": "Call reconnected",
"data": { ...the call... },
"credentials": { ...new join details... }
}
Things to Know
- Only the team member on the call can rejoin it.
- One join at a time: a new join replaces the team member's current connection on the call (see Joining a VOIP call in the Overview).
Error Responses
Besides the errors on every route (see Errors in the Overview):
| Status | reason | Message | When |
|---|---|---|---|
| 404 | NOT_FOUND | Call not found | No such team-member call in your organization. |
| 401 | UNAUTHORIZED | Your organization does not have a calling license or add-on. Please contact [email protected] | A WhatsApp call, and WhatsApp calling is not on your plan. |
| 400 | ANSWERED_ON_PHONE | This call is on the agent's phone: answer, decline or rejoin it there. | A PSTN call. |
| 400 | CALLING_NOT_SUPPORTED | Calling is not supported on this number. | The call's number no longer supports API calling. |
| 422 · 409 | — | Call cannot be reconnected by a different user · Call is not in progress · Only the agent on the call can rejoin it · Call is already connected to a different device | Someone else's call, a call that is over, or a call held on another device. |
Rate Limit
60 a minute per organization and team member.
Updated about 2 hours ago
What’s Next
Join with the new credentials. When the conversation is over, hang up.
Did this page help you?

