---
title: "Create Oauth Redirect Url"
method: POST
path: "/connections/oauth"
tags: ["connections"]
---

# Create Oauth Redirect Url

`POST /connections/oauth`

Creates a redirect url to redirect the user to when initializing an embedded connector.

## Request body

- OAuthUrlCreate
  - `redirect_uri` string, required
  - `partition` string, nullable
  - `source_type` 'backblaze' | 'confluence' | 'dropbox' | 'freshdesk' | 'onedrive' | 'google_drive' | 'gmail' | 'intercom' | 'notion' | 'salesforce' | 'sharepoint' | 'jira' | 'slack' | 's3' | 'gcs' | 'hubspot' | 'webcrawler' | 'zendesk'
  - `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`.
  - `mode` union
    - 'hi_res' | 'fast' | 'agentic_ocr'
    - MediaModeParam
      - `static` 'hi_res' | 'fast' | 'agentic_ocr', nullable
      - `audio` boolean, nullable
      - `video` 'audio_only' | 'video_only' | 'audio_video', nullable
  - `theme` 'light' | 'dark' | 'system', nullable — Sets the theme of the Ragie Web UI when the user lands there. Can be light, dark, or system to use whatever the system value is. If omitted, system is used.
  - `page_limit` integer, nullable — The maximum number of pages a connection will sync. The connection will be disabled after this limit is reached. Some in progress documents may continue processing after the limit is reached. The limit will be enforced at the start of the next document sync. Remove the limit by setting to null.
  - `config` object — Optional config per connector
  - `authenticator_id` string, uuid, nullable
  - `workflow` 'parse' | 'index'
  - `sync_filter` SyncFilter

## Response `200`

Successful Response

- OAuthUrlResponse
  - `url` string, required

## Other responses

- `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)