---
title: "POST /v1/call/trigger"
method: POST
path: "/v1/call/trigger"
---

# POST /v1/call/trigger

`POST /v1/call/trigger`

Triggers an immediate outbound call using the specified AI agent. The call is queued and processed asynchronously.

## Request body

- TriggerCallRequest
  - `agent_id` string, uuid, required — The UUID of the AI agent to conduct the call.
  - `to_number` string, required — The destination phone number in E.164 format (e.g. +919876543210). Must include country code. Pattern: + followed by 10-15 digits.
  - `metadata` object — Optional. Additional metadata to pass context to the agent (e.g. customer information, call objectives). Arbitrary key-value pairs.

## Response `202`

Call request accepted and queued

- TriggerCallResponse
  - `message` string, required — Human-readable status message.
  - `status` string, required — Status value, e.g. accepted.
  - `call_id` string, uuid, required — The unique identifier for the call (UUID). Use this to fetch call details later.

## Other responses

- `400` — Bad request - invalid request body or phone number format
- `404` — Agent not found or does not belong to your company
- `500` — Internal server error

## Changes

- **2026-04-10** `8d556733b51c` — 1 info
  - endpoint added
- **2026-02-04** `04695af70c18` — 1 breaking
  - api path removed without deprecation
- **2026-02-03** `b908213ad349` — 1 info
  - endpoint added
- **2026-02-03** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/i-stem/apis/samora-ai-api/changes/v1/call/trigger/post.md)

---

[API](https://skmtc.dev/i-stem/apis/samora-ai-api.md) · [All operations](https://skmtc.dev/i-stem/apis/samora-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/i-stem/samora-ai-api/revisions/cb390cb388d1/schema)