> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # Record an agent calendar event > Store a calendar event captured by an AI agent's `create_calendar_event` tool during a conversation and fire the `agent.calendar_event.created` webhook so your Google Calendar or Outlook integration can pick it up. Use it to let an agent book meetings or appointments on the customer's behalf and sync them to your own calendar of record. ## OpenAPI ````yaml /openapi.yaml post /api/v1/agents/calendar-events openapi: 3.1.0 info: title: Devotel CPaaS API description: Orbit by Devotel — Communications Platform as a Service API version: 1.0.0 contact: name: Devotel url: https://devotel.io email: support@devotel.io license: name: Proprietary servers: - url: https://api.orbit.devotel.io description: Production security: - Bearer: [] - ApiKey: [] tags: - name: Messages description: >- Send and manage messages across all channels (SMS, WhatsApp, RCS, Email, Viber, etc.) - name: Fax description: >- List and track fax (MMS/T.38) transmissions on Telnyx-backed fax numbers (sending flows through the Messaging API) - name: Agents description: AI agent creation, configuration, and execution - name: Voice description: Voice calls, IVR, conferencing, and SIP trunking - name: OnCall description: On-call rotations and escalation policy planning for incident alerting - name: Webhooks description: Webhook endpoint management and delivery logs - name: Numbers description: Phone number search, provisioning, and configuration - name: Brand Identity description: >- Unified cross-channel brand trust posture (10DLC, toll-free, WhatsApp, RCS, branded calling, number KYC) - name: Contacts description: Contact management, segmentation, and lifecycle tracking - name: Campaigns description: Marketing campaign orchestration and analytics - name: Flows description: Automation flow builder and execution engine - name: Templates description: Message template management and approval workflows - name: Settings description: Organization, channel, and user preference settings - name: Verify description: OTP generation and verification across channels - name: Push description: Push notification delivery via FCM and APNs - name: Integrations description: Third-party service connections and OAuth management - name: CDP description: >- Customer Data Platform — activation surface (CRM object sync, streaming destinations, ad-audience activation) - name: Files description: >- Server-to-server media upload, listing, retrieval, and deletion (signed-URL backed) - name: Commerce description: >- Omnichannel conversational-commerce — persistent cart + checkout state machine, channel-agnostic hosted pay-by-link, native WhatsApp checkout, and AP2-style agent payment mandates. - name: Sync description: >- Real-time shared-state primitive (Twilio Sync parity) — Documents, Maps, Lists, and ephemeral Streams, with change events relayed over the /api/v1/ws/sync WebSocket gateway - name: Risk description: >- Unified cross-channel Trust & Fraud risk scoring — fuses SMS-pumping, URL-reputation, Verify Fraud Guard, and Voice Biometrics signals into one composite verdict queryable before a send or a call. - name: Orby description: >- In-dashboard Orby operator assistant: streamed assistant turns, conversation threads, product knowledge-base search, and the tool-action approval gate. Available to signed-in operators only (dashboard session auth — API-key requests are rejected). paths: /api/v1/agents/calendar-events: post: tags: - Agents summary: Record an agent calendar event description: >- Store a calendar event captured by an AI agent's `create_calendar_event` tool during a conversation and fire the `agent.calendar_event.created` webhook so your Google Calendar or Outlook integration can pick it up. Use it to let an agent book meetings or appointments on the customer's behalf and sync them to your own calendar of record. requestBody: required: true content: application/json: schema: type: object required: - event_id - title - start_time properties: event_id: type: string description: >- Stable identifier for the event (used for idempotency and webhook correlation). title: type: string maxLength: 500 description: Event title. description: type: string maxLength: 2000 description: Optional event description. start_time: type: string description: Event start time (ISO-8601). end_time: type: string description: Optional event end time (ISO-8601). attendee_email: type: string format: email description: Optional attendee email address. conversation_id: type: string description: Conversation the event was booked from. example: event_id: evt_9f3c1a2b title: Product demo with Acme Corp description: 30-minute walkthrough of the messaging API. start_time: '2026-08-12T15:00:00Z' end_time: '2026-08-12T15:30:00Z' attendee_email: buyer@acme.example conversation_id: conv_5521 responses: '200': description: The event was stored and the webhook dispatched. content: application/json: schema: type: object properties: data: type: object properties: event_id: type: string title: type: string start_time: type: string end_time: type: string nullable: true status: type: string example: webhook_dispatched meta: $ref: '#/components/schemas/ResponseMeta' components: schemas: ResponseMeta: type: object required: - request_id - timestamp additionalProperties: false properties: request_id: type: string description: Unique request identifier (also returned as X-Request-Id header) timestamp: type: string format: date-time docs_url: type: string format: uri nullable: true securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT description: Dashboard JWT token from Clerk ApiKey: type: apiKey name: X-API-Key in: header description: Server-to-server API key (dv_live_sk_*) ````