POST
/
integrations
/
oauth_url

Authorizations

authorization
string
headerrequired

token <token>, corresponds to temporary access tokens.

Body

application/json
scope
string | null
service
enum<string>
required
Available options:
GOOGLE_DRIVE,
NOTION,
NOTION_DATABASE,
INTERCOM,
DROPBOX,
ONEDRIVE,
SHAREPOINT,
CONFLUENCE,
BOX,
ZENDESK,
ZOTERO,
S3,
GMAIL,
OUTLOOK,
TEXT,
CSV,
TSV,
PDF,
DOCX,
PPTX,
XLSX,
MD,
RTF,
JSON,
HTML,
RAW_TEXT,
WEB_SCRAPE,
RSS_FEED,
FRESHDESK,
GITBOOK,
SALESFORCE,
GITHUB,
SLACK,
JPG,
PNG,
JPEG,
MP3,
MP2,
AAC,
WAV,
FLAC,
PCM,
M4A,
OGG,
OPUS,
MPEG,
MPG,
MP4,
WMV,
AVI,
MOV,
MKV,
FLV,
WEBM,
EML
tags
any | null
chunk_size
integer | null
chunk_overlap
integer | null
skip_embedding_generation
boolean | null
embedding_model
enum<string> | null
Available options:
OPENAI,
AZURE_OPENAI,
AZURE_ADA_LARGE_256,
AZURE_ADA_LARGE_1024,
AZURE_ADA_LARGE_3072,
AZURE_ADA_SMALL_512,
AZURE_ADA_SMALL_1536,
COHERE_MULTILINGUAL_V3,
VERTEX_MULTIMODAL,
OPENAI_ADA_LARGE_256,
OPENAI_ADA_LARGE_1024,
OPENAI_ADA_LARGE_3072,
OPENAI_ADA_SMALL_512,
OPENAI_ADA_SMALL_1536,
SOLAR_1_MINI
zendesk_subdomain
string | null
microsoft_tenant
string | null
sharepoint_site_name
string | null
confluence_subdomain
string | null
generate_sparse_vectors
boolean | null
prepend_filename_to_chunks
boolean | null
max_items_per_chunk
integer | null

Number of objects per chunk. For csv, tsv, xlsx, and json files only.

salesforce_domain
string | null
sync_files_on_connection
boolean | null

Used to specify whether Carbon should attempt to sync all your files automatically when authorization is complete. This is only supported for a subset of connectors and will be ignored for the rest. Supported connectors: Intercom, Zendesk, Gitbook, Confluence, Salesforce, Freshdesk

set_page_as_boundary
boolean
default: false
data_source_id
integer | null

Used to specify a data source to sync from if you have multiple connected. It can be skipped if you only have one data source of that type connected or are connecting a new account.

connecting_new_account
boolean | null

Used to connect a new data source. If not specified, we will attempt to create a sync URL for an existing data source based on type and ID.

request_id
string
default: f7ec5637-a057-4126-8fb8-41b7ecc80458

This request id will be added to all files that get synced using the generated OAuth URL

use_ocr
boolean | null

Enable OCR for files that support it. Supported formats: pdf

parse_pdf_tables_with_ocr
boolean | null
enable_file_picker
boolean
default: true

Enable integration's file picker for sources that support it. Supported sources: BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT

sync_source_items
boolean
default: true

Enabling this flag will fetch all available content from the source to be listed via list items endpoint

incremental_sync
boolean
default: false

Only sync files if they have not already been synced or if the embedding properties have changed. This flag is currently supported by ONEDRIVE, GOOGLE_DRIVE, BOX, DROPBOX, INTERCOM, GMAIL, OUTLOOK. It will be ignored for other data sources.

file_sync_config
object | null

Used to configure file syncing (automatic or through connector's inbuilt file picker) on completion of the OAuth flow

Response

200 - application/json
oauth_url
string
required
Get White LabelUpload File