---
title: "Initiate outbound call"
method: POST
path: "/v1/call"
tags: ["Calls"]
---

# Initiate outbound call

`POST /v1/call`

Initiate an outbound voice call to the specified phone number using the configured agent. Returns a call ID immediately for tracking. The call is placed asynchronously - use the conversations endpoint to retrieve call results once the call completes. Rate limited to 10 requests per minute.

## Request body

- CreateCallRequest
  - `agentId` string, uuid, required — UUID of the agent to use for the call
  - `phoneNumber` string, required — Phone number to call in E.164 format
  - `variables` object — Custom variables to pass to the assistant. These override contact field values.

## Response `200`

Call initiated successfully. Returns call ID for tracking.

- CallResponse
  - `callId` string, required — Call identifier for tracking. Use this ID to query call status and results.

## Other responses

- `400` — Validation error - invalid phone number format, invalid agent ID, agent not active, or no phone number available for the workspace.
- `401` — Missing or invalid API key
- `404` — Agent not found (includes unauthorized access for security)
- `429` — Rate limit exceeded (10 requests per minute). Retry-After header included.
- `502` — Call could not be initiated. Please try again.

---

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