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

# Update user calendar sync provider

> Updates the calendar sync provider settings for a specific user. Only company admins can update calendar sync settings. The calendar sync provider determines which calendar service (Google, Outlook, iCloud, CalDAV, Exchange, Nextcloud, SmartWe) is used to sync the user's availability and create calendar events for bookings. Provide the calendar connection ID and provider type to set the sync provider.



## OpenAPI

````yaml /openapi.json patch /v4/user/{id}/calendar-sync
openapi: 3.0.0
info:
  title: meetergo Platform API
  description: >-
    Comprehensive scheduling API for creating users, managing availability,
    handling bookings, and connecting calendar providers. Enables seamless
    integration with external platforms and applications.
  version: 0.0.0
  contact: {}
  termsOfService: https://www.meetergo.com/tos/
servers: []
security: []
tags:
  - name: User V4
    description: Create and manage users in your workspace
  - name: Meeting Type V4
    description: Configure meeting templates with durations, buffers, and conferencing
  - name: availability
    description: Manage weekly schedules and availability settings
  - name: Booking V4
    description: Create new bookings
  - name: Booking Availability V4
    description: Query available time slots for booking
  - name: Appointment V4
    description: Manage existing appointments
  - name: Attendee V4
    description: Manage attendee details and notes
  - name: Calendar Connections V4
    description: Connect and sync external calendars
  - name: One Time Booking Link V4
    description: Create single-use booking links
  - name: availability-exception
    description: Override availability for specific dates
  - name: Booking Link V4
    description: Configure various booking page types
  - name: Personal Page V4
    description: Manage user profile pages
  - name: Handoff V4
    description: Reassign meetings to other hosts
  - name: Calendar Auth V4
    description: OAuth callbacks for calendar providers
  - name: Queue V4
    description: Round-robin and queue-based routing (Beta)
  - name: Queue User Group V4
    description: Manage queue user groups (Beta)
  - name: Meeting Type Template V4
    description: Reusable meeting type configurations (Beta)
  - name: Attendee Pending V4
    description: Manage pending attendee approvals (Beta)
  - name: Provisional Booking V4
    description: Manage provisional/unconfirmed bookings (Beta)
paths:
  /v4/user/{id}/calendar-sync:
    patch:
      tags:
        - User V4
      summary: Update user calendar sync provider
      description: >-
        Updates the calendar sync provider settings for a specific user. Only
        company admins can update calendar sync settings. The calendar sync
        provider determines which calendar service (Google, Outlook, iCloud,
        CalDAV, Exchange, Nextcloud, SmartWe) is used to sync the user's
        availability and create calendar events for bookings. Provide the
        calendar connection ID and provider type to set the sync provider.
      operationId: updateUserCalendarSync
      parameters:
        - name: id
          required: true
          in: path
          description: Unique identifier of the user to update
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateUserCalendarSyncDTO'
      responses:
        '200':
          description: Calendar sync provider updated successfully
        '403':
          description: Forbidden - Only admins can update calendar sync settings
        '404':
          description: User not found or does not belong to your company
      security:
        - ApiUserHeader: []
        - JWT: []
        - ApiKey: []
components:
  schemas:
    UpdateUserCalendarSyncDTO:
      type: object
      properties:
        calendarSyncProviders:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/CalendarSync'
        id:
          type: string
          description: |-
            id of the user to be updated.
            If undefined, the user making the request is updated
      required:
        - calendarSyncProviders
    CalendarSync:
      type: object
      properties:
        id:
          type: string
        type:
          allOf:
            - $ref: '#/components/schemas/CalendarSyncProvider'
      required:
        - id
        - type
    CalendarSyncProvider:
      type: string
      enum:
        - google
        - outlook
        - icloud
        - caldav
        - exchange
        - nextcloud
        - smart-we
        - salesforce
  securitySchemes:
    ApiUserHeader:
      type: apiKey
      in: header
      name: x-meetergo-api-user-id
      description: >-
        User ID to act on behalf of. Platform API Keys only (required with an
        API Key unless the endpoint states otherwise). Requests authenticated
        with a Personal Access Token are rejected if this header names another
        user.
    JWT:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT Bearer token for standard user authentication
    ApiKey:
      scheme: bearer
      bearerFormat: API Key
      type: http
      description: >-
        Bearer token: a Platform API Key (format: ak_live:<uuid>:<secret>) or a
        Personal Access Token (format: rgo-...). PATs always act as the token
        owner.

````