---
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

---

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