---
title: "Create Authenticator Connection"
method: POST
path: "/authenticators/{authenticator_id}/connection"
tags: ["authenticators", "beta", "enterprise"]
---

# Create Authenticator Connection

`POST /authenticators/{authenticator_id}/connection`

Create a connector for a given authenticator. This requires credentials dependent on the provider. For google drive it is a refresh token.

## Path parameters

- `authenticator_id` string, uuid, required

## Request body

- CreateAuthenticatorConnection
  - `partition_strategy` MediaModeParam, required
    - `static` 'hi_res' | 'fast' | 'agentic_ocr', nullable
    - `audio` boolean, nullable
    - `video` 'audio_only' | 'video_only' | 'audio_video', nullable
  - `partition` string, nullable
  - `page_limit` integer, nullable
  - `config` object, nullable
  - `metadata` object — Metadata for the document. Keys must be strings. Values may be strings, numbers, booleans, or lists of strings. Numbers may be integers or floating point and will be converted to 64 bit floating point. 1000 total values are allowed. Each item in an array counts towards the total. The following keys are reserved for internal use: `document_id`, `document_type`, `document_source`, `document_name`, `document_uploaded_at`, `start_time`, `end_time`, `chunk_content_type`.
  - `workflow` 'parse' | 'index'
  - `sync_filter` SyncFilter
  - `connection` union, required
    - AuthenticatorConfluenceConnection
      - `provider` 'confluence', required
      - `data` ConfluenceData[], required
        - `resource_id` string, required
        - `space_id` integer, required
        - `space_key` string, required
        - `space_name` string, required
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorDropboxConnection
      - `provider` 'dropbox', required
      - `data` FolderData, required
        - `folder_id` string, required
        - `folder_name` string, required
      - `email` string, required — The email of the Dropbox account this is for
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorGoogleDriveConnection
      - `provider` 'google_drive', required
      - `data` GoogleFolderData[], required
        - `id` string, required
        - `name` string, required
        - `mime_type` string, required
      - `email` string, required — The email of the Google Drive account this is for
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorGmailConnection
      - `provider` 'gmail', required
      - `data` GmailData, required
        - `label` string, nullable
      - `email` string, required — The email of the Google Drive account this is for
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorHubspotConnection
      - `provider` 'hubspot', required
      - `data` HubspotData, required
        - `companies` boolean, required
        - `contacts` boolean, required
        - `contact_notes` boolean, required
        - `deals` boolean, required
        - `deal_notes` boolean, required
        - `emails` boolean, required
        - `tasks` boolean, required
      - `hub_id` string, required
      - `hub_domain` string, required
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorJiraConnection
      - `provider` 'jira', required
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorNotionConnection
      - `provider` 'notion', required
      - `workspace_id` string, required
      - `workspace_name` string, required
      - `user_email` string, required — The email of the Notion account this is for
      - `credentials` AccessTokenCredentials, required
        - `access_token` string, required
    - AuthenticatorOnedriveConnection
      - `provider` 'onedrive', required
      - `data` OnedriveData, required
        - `drive_id` string, required
        - `folder_id` string, required
        - `folder_name` string, required
      - `user_email` string, required — The email of the Onedrive account this is for
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorSalesforceConnection
      - `provider` 'salesforce', required
      - `user_email` string, required — The email of the Salesforce account this is for
      - `url` string, required — The url of your Salesforce instance, where you go to login.
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorSharepointConnection
      - `provider` 'sharepoint', required
      - `data` SharepointData, required
        - `site` SharepointSiteData, required
          - `id` string, required
          - `name` string, required
          - `display_name` string, required
        - `drive` SharepointDriveData, required
          - `id` string, required
          - `name` string, required
        - `files` SharepointFileData[], required
          - `id` string, required
          - `name` string, required
          - `path` string, required
          - `type` 'file' | 'folder', required
          - `drive_id` string, nullable, required
      - `user_email` string, required — The email of the Sharepoint account this is for
      - `credentials` OAuthRefreshTokenCredentials, required
        - `refresh_token` string, required
    - AuthenticatorSlackConnection
      - `provider` 'slack', required
      - `data` SlackData, required
        - `channel_id` string, required
        - `channel_name` string, required
      - `user_email` string, required — The email of the Slack account this is for
      - `credentials` AccessTokenCredentials, required
        - `access_token` string, required

## Response `201`

Successful Response

- Connection
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `metadata` object, required
  - `type` string, required
  - `name` string, required
  - `source` union, required
    - string
    - string[]
    - object
  - `enabled` boolean, required
  - `disabled_by_system_reason` 'connection_over_total_page_limit' | 'authentication_failed' | 'tenant_account_disabled', nullable, required
  - `last_synced_at` string, date-time, nullable
  - `syncing` boolean, nullable
  - `partition` string, nullable
  - `page_limit` integer, nullable, required
  - `sync_filter` SyncFilter, required
  - `disabled_by_system` boolean, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ragie/apis/ragie-api.md) · [All operations](https://skmtc.dev/ragie/apis/ragie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ragie/ragie-api/revisions/ffdf960539ca/schema)