integrations

Register or rotate an OAuth client

Point a connector at the organization's own OAuth client, or rotate its secrets.

put/v1/integrations/oauth-clients/{provider}

Path parameters

provider'google_drive' | 'gmail' | 'slack' required

The connector to configure

The connector to configure

Request body

client_idstring required

The OAuth client ID from the customer's Google Cloud project or Slack app

client_secretstring password required

The OAuth client secret. Write-only: it is encrypted at rest and never returned.

signing_secretstring password nullable

The app's signing secret, used to verify the webhooks it sends. Required for Slack; not accepted for Google connectors. Write-only.

return_urlstring nullable

Required. Where the connector's OAuth callback returns the user after consent. Must be an absolute https URL (http is allowed for localhost). The outcome is appended as query parameters: provider, status, and installation_id or error.

Response

The connector slot after the change

Changes