> ## Documentation Index > Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt > Use this file to discover all available pages before exploring further. # Create Outbound Call > Trigger an immediate or scheduled AI agent outbound phone call. Pass the destination number and any call context required by the agent. ## OpenAPI ````yaml POST /agents/{agentUuid}/outbound-calls openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Recommended Headers We recommend including the `Accept: application/json` header in all API requests to ensure you receive JSON responses. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records paths: /agents/{agentUuid}/outbound-calls: post: tags: - AI Agent summary: Create outbound call description: >- Trigger an outbound call from an AI agent. The agent must be published and enabled. You can trigger calls immediately or schedule them for a future time. Required scope: `outbound-calls:write`. For integration examples, see the [n8n workflow guide](https://zeeg.me/en/help/articles/14038528-how-to-build-a-workflow-with-n8n-and-zeeg). operationId: post-agents-agentUuid-outbound-calls parameters: - schema: type: string format: uuid in: path name: agentUuid required: true description: The UUID of the AI agent. requestBody: required: true content: application/json: schema: type: object required: - phoneNumber - email - fullName properties: phoneNumber: type: string description: Phone number in E.164 format (e.g. +4915112345678). email: type: string format: email description: Email address of the person to call. fullName: type: string description: Full name of the person to call. additionalData: type: string description: Additional context for the AI agent to use during the call. scheduledTime: type: string description: >- Schedule the call for a future time. Format: YYYY-MM-DD HH:mm:ss. Must be in the future. examples: Immediate call: value: phoneNumber: '+4915112345678' email: sophie.laurent@northwind.io fullName: Sophie Laurent additionalData: >- Sophie is interested in the enterprise plan. She prefers to speak in English. Scheduled call: value: phoneNumber: '+4915112345678' email: sophie.laurent@northwind.io fullName: Sophie Laurent additionalData: Follow-up call regarding the demo scheduled last week. scheduledTime: '2026-04-20 14:00:00' responses: '201': description: Created content: application/json: schema: type: object properties: success: type: boolean element: type: object properties: id: type: string format: uuid example: d05565a7-fe5e-4036-ae0d-c1132fb91543 agentId: type: string format: uuid example: 3b7123e8-78f7-42c1-bf4d-646ee06d4ddf phoneNumber: type: string email: type: string format: email fullName: type: string additionalData: type: string nullable: true firstMessage: type: string nullable: true scheduledTime: type: string nullable: true triggeredAt: type: string nullable: true status: type: string enum: - pending - completed - failed callLogId: type: integer nullable: true callLog: type: object nullable: true error: type: string nullable: true retryLogs: type: array items: {} createdAt: type: string format: date-time updatedAt: type: string format: date-time examples: Call created: value: success: true element: id: d05565a7-fe5e-4036-ae0d-c1132fb91543 agentId: 3b7123e8-78f7-42c1-bf4d-646ee06d4ddf phoneNumber: '+4915112345678' email: sophie.laurent@northwind.io fullName: Sophie Laurent additionalData: >- Sophie is interested in the enterprise plan. She prefers to speak in English. firstMessage: null scheduledTime: null triggeredAt: null status: pending callLogId: null callLog: null error: null retryLogs: [] createdAt: '2026-04-15T10:00:00.000000Z' updatedAt: '2026-04-15T10:00:00.000000Z' '400': description: Bad Request content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Agent inactive: value: success: false message: Agent is not active status: 400 '401': $ref: '#/components/responses/401' '403': description: Forbidden content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Missing scope: value: success: false message: >- Your token is missing the required scope: outbound-calls:write. status: 403 '404': description: Not Found content: application/json: schema: type: object properties: error: type: string examples: Agent not found: value: error: Agent not found '422': description: Unprocessable Entity content: application/json: schema: type: object properties: message: type: string errors: type: object examples: Validation errors: value: message: The given data was invalid. errors: phoneNumber: - The phone number must be in E.164 format. scheduledTime: - The scheduled time must be a date after now. '500': description: Internal Server Error content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Invalid UUID format: value: success: false message: Invalid UUID format. status: 500 security: - bearer: [] components: responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. securitySchemes: bearer: type: http scheme: bearer description: '' ````