--- title: "POST /v1/connect/pre-connect" method: POST path: "/v1/connect/pre-connect" --- # POST /v1/connect/pre-connect `POST /v1/connect/pre-connect` ## Request body - object - `connector_config_id` string, required — Must correspond to data.connector_name. Technically id should imply connector_name already but there is no way to specify a discriminated union with id alone. - `options` object - `integrationExternalId` union - string - number - `connectionExternalId` union - string - number - `discriminated_data` union - ConnectorAcmeApikeyDiscriminatedPreConnectInput - `connector_name` 'acme-apikey', required - `pre_connect_input` object, required - ConnectorAcmeOauth2DiscriminatedPreConnectInput - `connector_name` 'acme-oauth2', required - `pre_connect_input` object, required - ConnectorAsanaDiscriminatedPreConnectInput - `connector_name` 'asana', required - `pre_connect_input` object, required - ConnectorBigqueryDiscriminatedPreConnectInput - `connector_name` 'bigquery', required - `pre_connect_input` object, required - ConnectorBoxDiscriminatedPreConnectInput - `connector_name` 'box', required - `pre_connect_input` object, required - ConnectorCalendlyDiscriminatedPreConnectInput - `connector_name` 'calendly', required - `pre_connect_input` object, required - ConnectorConfluenceDiscriminatedPreConnectInput - `connector_name` 'confluence', required - `pre_connect_input` object, required - `site_url` string, uri, required — Your Atlassian site URL (e.g., https://your-domain.atlassian.net). You can find this in your browser when logged into Confluence. - ConnectorDatabricksDiscriminatedPreConnectInput - `connector_name` 'databricks', required - `pre_connect_input` object, required - ConnectorDiscordDiscriminatedPreConnectInput - `connector_name` 'discord', required - `pre_connect_input` object, required - ConnectorDropboxDiscriminatedPreConnectInput - `connector_name` 'dropbox', required - `pre_connect_input` object, required - ConnectorFigmaDiscriminatedPreConnectInput - `connector_name` 'figma', required - `pre_connect_input` object, required - ConnectorGithubDiscriminatedPreConnectInput - `connector_name` 'github', required - `pre_connect_input` object, required - ConnectorGoogleCalendarDiscriminatedPreConnectInput - `connector_name` 'google-calendar', required - `pre_connect_input` object, required - ConnectorGoogleDocsDiscriminatedPreConnectInput - `connector_name` 'google-docs', required - `pre_connect_input` object, required - ConnectorGoogleDriveDiscriminatedPreConnectInput - `connector_name` 'google-drive', required - `pre_connect_input` object, required - ConnectorGoogleMailDiscriminatedPreConnectInput - `connector_name` 'google-mail', required - `pre_connect_input` object, required - ConnectorGoogleSheetDiscriminatedPreConnectInput - `connector_name` 'google-sheet', required - `pre_connect_input` object, required - ConnectorHubspotDiscriminatedPreConnectInput - `connector_name` 'hubspot', required - `pre_connect_input` object, required - ConnectorInstagramDiscriminatedPreConnectInput - `connector_name` 'instagram', required - `pre_connect_input` object, required - ConnectorJiraDiscriminatedPreConnectInput - `connector_name` 'jira', required - `pre_connect_input` object, required - `site_url` string, uri, required — Your Atlassian site URL (e.g., https://your-domain.atlassian.net). You can find this in your browser when logged into Jira. - ConnectorLinearDiscriminatedPreConnectInput - `connector_name` 'linear', required - `pre_connect_input` object, required - ConnectorMondayDiscriminatedPreConnectInput - `connector_name` 'monday', required - `pre_connect_input` object, required - ConnectorNotionDiscriminatedPreConnectInput - `connector_name` 'notion', required - `pre_connect_input` object, required - ConnectorOnedriveDiscriminatedPreConnectInput - `connector_name` 'onedrive', required - `pre_connect_input` object, required - ConnectorOutlookDiscriminatedPreConnectInput - `connector_name` 'outlook', required - `pre_connect_input` object, required - ConnectorResendDiscriminatedPreConnectInput - `connector_name` 'resend', required - `pre_connect_input` object, required - ConnectorSalesforceDiscriminatedPreConnectInput - `connector_name` 'salesforce', required - `pre_connect_input` object, required - ConnectorSendgridDiscriminatedPreConnectInput - `connector_name` 'sendgrid', required - `pre_connect_input` object, required - ConnectorSharepointDiscriminatedPreConnectInput - `connector_name` 'sharepoint', required - `pre_connect_input` object, required - ConnectorSlackDeployedAgentDiscriminatedPreConnectInput - `connector_name` 'slack-deployed-agent', required - `pre_connect_input` object, required - ConnectorSlackDiscriminatedPreConnectInput - `connector_name` 'slack', required - `pre_connect_input` object, required - ConnectorSnowflakeDiscriminatedPreConnectInput - `connector_name` 'snowflake', required - `pre_connect_input` object, required - ConnectorSpotifyDiscriminatedPreConnectInput - `connector_name` 'spotify', required - `pre_connect_input` object, required - ConnectorYoutubeDiscriminatedPreConnectInput - `connector_name` 'youtube', required - `pre_connect_input` object, required - ConnectorZendeskDiscriminatedPreConnectInput - `connector_name` 'zendesk', required - `pre_connect_input` object, required - `subdomain` string, required — Your Zendesk subdomain. This is the first part of your Zendesk URL. For example, if your Zendesk URL is https://acme.zendesk.com, then your subdomain is "acme". - ConnectorZoomDiscriminatedPreConnectInput - `connector_name` 'zoom', required - `pre_connect_input` object, required - ConnectorApolloDiscriminatedPreConnectInput - `connector_name` 'apollo', required - `pre_connect_input` object, required - ConnectorPlaidDiscriminatedPreConnectInput - `connector_name` 'plaid', required - `pre_connect_input` object, required - `sandboxPublicTokenCreate` boolean - `language` 'en' | 'fr' | 'es' | 'nl' | 'de' - ConnectorPostgresDiscriminatedPreConnectInput - `connector_name` 'postgres', required - `pre_connect_input` object, required - ConnectorSlackAgentDiscriminatedPreConnectInput - `connector_name` 'slack-agent', required - `pre_connect_input` object, required - ConnectorSlackAgentBuilderDiscriminatedPreConnectInput - `connector_name` 'slack-agent-builder', required - `pre_connect_input` object, required - ConnectorStripeDiscriminatedPreConnectInput - `connector_name` 'stripe', required - `pre_connect_input` object, required - ConnectorStripeAgentSandboxDiscriminatedPreConnectInput - `connector_name` 'stripe-agent-sandbox', required - `pre_connect_input` object, required - `email` string, email, required — Email address of the user for sandbox prefill - `country` string — Country code for sandbox prefill - ConnectorTwilioDiscriminatedPreConnectInput - `connector_name` 'twilio', required - `pre_connect_input` object, required - ConnectorWorkatoDiscriminatedPreConnectInput - `connector_name` 'workato', required - `pre_connect_input` object, required ## Response `200` Successful response - union - ConnectorAcmeApikeyDiscriminatedConnectInput - `connector_name` 'acme-apikey', required - `connect_input` object, required - ConnectorAcmeOauth2DiscriminatedConnectInput - `connector_name` 'acme-oauth2', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorAsanaDiscriminatedConnectInput - `connector_name` 'asana', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorBigqueryDiscriminatedConnectInput - `connector_name` 'bigquery', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorBoxDiscriminatedConnectInput - `connector_name` 'box', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorCalendlyDiscriminatedConnectInput - `connector_name` 'calendly', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorConfluenceDiscriminatedConnectInput - `connector_name` 'confluence', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorDatabricksDiscriminatedConnectInput - `connector_name` 'databricks', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorDiscordDiscriminatedConnectInput - `connector_name` 'discord', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorDropboxDiscriminatedConnectInput - `connector_name` 'dropbox', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorFigmaDiscriminatedConnectInput - `connector_name` 'figma', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorGithubDiscriminatedConnectInput - `connector_name` 'github', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorGoogleCalendarDiscriminatedConnectInput - `connector_name` 'google-calendar', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorGoogleDocsDiscriminatedConnectInput - `connector_name` 'google-docs', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorGoogleDriveDiscriminatedConnectInput - `connector_name` 'google-drive', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorGoogleMailDiscriminatedConnectInput - `connector_name` 'google-mail', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorGoogleSheetDiscriminatedConnectInput - `connector_name` 'google-sheet', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorHubspotDiscriminatedConnectInput - `connector_name` 'hubspot', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorInstagramDiscriminatedConnectInput - `connector_name` 'instagram', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorJiraDiscriminatedConnectInput - `connector_name` 'jira', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorLinearDiscriminatedConnectInput - `connector_name` 'linear', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorMondayDiscriminatedConnectInput - `connector_name` 'monday', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorNotionDiscriminatedConnectInput - `connector_name` 'notion', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorOnedriveDiscriminatedConnectInput - `connector_name` 'onedrive', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorOutlookDiscriminatedConnectInput - `connector_name` 'outlook', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorResendDiscriminatedConnectInput - `connector_name` 'resend', required - `connect_input` object, required - ConnectorSalesforceDiscriminatedConnectInput - `connector_name` 'salesforce', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorSendgridDiscriminatedConnectInput - `connector_name` 'sendgrid', required - `connect_input` object, required - ConnectorSharepointDiscriminatedConnectInput - `connector_name` 'sharepoint', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorSlackDeployedAgentDiscriminatedConnectInput - `connector_name` 'slack-deployed-agent', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorSlackDiscriminatedConnectInput - `connector_name` 'slack', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorSnowflakeDiscriminatedConnectInput - `connector_name` 'snowflake', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorSpotifyDiscriminatedConnectInput - `connector_name` 'spotify', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorYoutubeDiscriminatedConnectInput - `connector_name` 'youtube', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorZendeskDiscriminatedConnectInput - `connector_name` 'zendesk', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorZoomDiscriminatedConnectInput - `connector_name` 'zoom', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorApolloDiscriminatedConnectInput - `connector_name` 'apollo', required - `connect_input` object, required - ConnectorPlaidDiscriminatedConnectInput - `connector_name` 'plaid', required - `connect_input` union, required - object - `link_token` string, required - object - `public_token` string, required - ConnectorPostgresDiscriminatedConnectInput - `connector_name` 'postgres', required - `connect_input` object, required - ConnectorSlackAgentDiscriminatedConnectInput - `connector_name` 'slack-agent', required - `connect_input` object, required - `configuration_url` string, required — Configuration URL - https://api.slack.com/apps/A1234567890/oauth... - ConnectorSlackAgentBuilderDiscriminatedConnectInput - `connector_name` 'slack-agent-builder', required - `connect_input` object, required - `code_verifier` string — Code verifier for PKCE - `authorization_url` string, required — URL to take user to for approval - ConnectorStripeDiscriminatedConnectInput - `connector_name` 'stripe', required - `connect_input` object, required - `secret` string, required — Stripe secret key for the sandbox - `publishable` string, required — Stripe publishable key for the sandbox - `mcp` string, required — MCP access token - ConnectorStripeAgentSandboxDiscriminatedConnectInput - `connector_name` 'stripe-agent-sandbox', required - `connect_input` object, required - `claim_url` string, uri — URL to claim/access the Stripe sandbox - `secret` string, required — Stripe secret key for the sandbox - `publishable` string, required — Stripe publishable key for the sandbox - `mcp` string, required — MCP access token - ConnectorTwilioDiscriminatedConnectInput - `connector_name` 'twilio', required - `connect_input` object, required - ConnectorWorkatoDiscriminatedConnectInput - `connector_name` 'workato', required - `connect_input` object, required ## Other responses - `400` — Invalid input data - `401` — Authorization not provided - `403` — Insufficient access - `500` — Internal server error --- [API](https://skmtc.net/openintegrations/apis/openint-api.md) · [All operations](https://skmtc.net/openintegrations/apis/openint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openintegrations/openint-api/versions/1b84cd7f5c05/schema)