---
title: "Schedule an AI voice-agent callback (callbacks scope required)"
method: POST
path: "/api/v1/callbacks"
---

# Schedule an AI voice-agent callback (callbacks scope required)

`POST /api/v1/callbacks`

## Request

- Base URL: `https://salestick-backend-647994203646.europe-central2.run.app`
- URL: `https://salestick-backend-647994203646.europe-central2.run.app/api/v1/callbacks`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Schedules the team's Canarics AI agent to call a customer back. Only numbers the team already has call history with are accepted (consent gate, never cold calls). Max 20 per day per team; repeats to the same number are deduplicated. The call is placed by the outbound loop during 09:00-20:00 in the given timezone, up to 2 attempts; the analyzed result arrives as a call.analyzed webhook event.

## Request body

- object
  - `number` string, required: Customer number, E.164, with prior call history
  - `reason` string, required: Why the customer is called back, grounded in their own request, becomes the agent's briefing
  - `agentId` string: Which voice agent calls, needed only when the team has several
  - `timezone` string: IANA timezone for the calling window, default Europe/Riga

## Response `201`

Callback scheduled

- object
  - `callbackId` string
  - `status` string
  - `fromNumber` string
  - `note` string

## Other responses

- `400`: Invalid number/reason, disallowed destination, or agentId needed
- `403`: Key lacks the callbacks scope, the team is not on the outbound plan, or the number has no call history with the team
- `409`: A recent callback to this number already exists
- `429`: Daily callback limit reached

---

[API](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents.md) · [All operations](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/revisions/e89711c2f1ba?raw)