> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Complete meeting calendar authorization

> Browser redirect after calendar consent. Use the returned oauth_url rather than constructing this request. Verified state identifies the connecting user. Returns HTML for success, cancellation, or failure; no JSON error envelope or bearer token is used.



## OpenAPI

````yaml /openapi/source/external/meeting-sessions/meeting-sessions.json get /meeting_bot/calendar/oauth_callback
openapi: 3.1.0
info:
  title: Telnyx Meeting Sessions API
  version: 2.0.0
  description: >-
    Programmatically create, control, and inspect Telnyx Meeting Sessions,
    including real-time actions, events, transcripts, and artifacts.
  x-latency-category: interactive
  x-endpoint-cost: light
servers:
  - url: https://api.telnyx.com/v2
security:
  - bearerAuth: []
tags:
  - name: Meeting Sessions
    description: Create, list, retrieve, update, and stop meeting sessions.
  - name: Meeting Session Actions
    description: Send real-time speech and chat actions to an active meeting session.
  - name: Meeting Session Data
    description: >-
      Read lifecycle events and transcript segments for a meeting session, and
      delete its recording media.
  - name: Meeting Session Artifacts
    description: Create and retrieve asynchronous summaries and action-item artifacts.
  - name: Meeting Session Webhooks
    description: Outbound webhook deliveries for meeting session events.
  - name: Meeting Calendar Connections
    description: Connect calendars and manage automatic meeting joins.
paths:
  /meeting_bot/calendar/oauth_callback:
    get:
      tags:
        - Meeting Calendar Connections
      summary: Complete meeting calendar authorization
      description: >-
        Browser redirect after calendar consent. Use the returned oauth_url
        rather than constructing this request. Verified state identifies the
        connecting user. Returns HTML for success, cancellation, or failure; no
        JSON error envelope or bearer token is used.
      operationId: completeMeetingCalendarAuthorization
      parameters:
        - name: code
          in: query
          description: Authorization code supplied by the calendar provider.
          schema:
            type: string
        - name: state
          in: query
          description: Unmodified signed state from the authorization URL.
          schema:
            type: string
        - name: error
          in: query
          description: >-
            Authorization error supplied by the calendar provider, such as
            access_denied.
          schema:
            type: string
      responses:
        '200':
          description: Calendar connected, or the user cancelled authorization.
          content:
            text/html:
              schema:
                type: string
              example: >-
                <!doctype html><html><body><h1>Calendar
                connected</h1></body></html>
        '400':
          description: Invalid, expired, or rejected authorization.
          content:
            text/html:
              schema:
                type: string
              example: >-
                <!doctype html><html><body><h1>Invalid
                request</h1></body></html>
        '409':
          description: This user already has a connection for this calendar platform.
          content:
            text/html:
              schema:
                type: string
              example: >-
                <!doctype html><html><body><h1>Calendar already
                connected</h1></body></html>
        '500':
          description: Unexpected connection failure.
          content:
            text/html:
              schema:
                type: string
              example: >-
                <!doctype html><html><body><h1>Calendar connection
                failed</h1></body></html>
        '502':
          description: Calendar authorization exchange failed.
          content:
            text/html:
              schema:
                type: string
              example: >-
                <!doctype html><html><body><h1>Calendar connection
                failed</h1></body></html>
        '503':
          description: Calendar connection is temporarily unavailable.
          content:
            text/html:
              schema:
                type: string
              example: >-
                <!doctype html><html><body><h1>Calendar connections
                unavailable</h1></body></html>
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````