---
title: "Initiate Click to Call"
method: POST
path: "/v1/click_to_call"
---

# Initiate Click to Call

`POST /v1/click_to_call`

## Request

- Base URL: `https://api-smartflo.tatateleservices.com`
- URL: `https://api-smartflo.tatateleservices.com/v1/click_to_call`
- Auth: none required
- TypeScript: <https://skmtc.dev/tatatelebusiness/apis/smartflo-base-api-config/docs/v1/click_to_call/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `Authorization` string, required

## Request body

- object
  - `agent_number` string, required: Smartflo agent who will receive the first leg of the call. Supports Agent Mobile Number, Agent ID, or Agent Extension.
  - `destination_number` string, required: Mobile or landline number of the customer to be called.
  - `caller_id` string, required: Caller ID displayed to the destination party. If omitted, the default Pilot Number is used.
  - `async` integer, required: Specifies asynchronous processing. Only 1 is supported; the request immediately returns the acceptance status.
  - `call_timeout` integer: Maximum duration of the connected call in seconds. The call is automatically disconnected after the timeout.
  - `custom_identifier` string: Supports up to 10 custom identifiers, with a combined JSON size of up to 512 characters. Values must be alphanumeric; $ is not supported.

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `f41acb27d695`: 1 info
  - api operation id `v1click_to_call` removed and replaced with `v1click_to_call-1`

[Operation history](https://skmtc.dev/tatatelebusiness/apis/smartflo-base-api-config/changes/v1/click_to_call/post.md)

---

[API](https://skmtc.dev/tatatelebusiness/apis/smartflo-base-api-config.md) - [All operations](https://skmtc.dev/tatatelebusiness/apis/smartflo-base-api-config/llms.txt) - [OpenAPI document](https://skmtc.dev/tatatelebusiness/apis/smartflo-base-api-config/revisions/f41acb27d695?raw)