Mixedbread

Register OAuth Client

Register the organization's own OAuth client for a connector, or rotate its secrets.

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

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Api key to access Mixedbreads API

Path Parameters

provider*Provider

The connector to configure

Value in"google_drive""gmail""slack"

Request Body

application/json
  1. body

The customer's OAuth client credentials

client_id*Client Id

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

Length1 <= length <= 256
client_secret*Client Secret

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

Formatpassword
signing_secret?|

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

return_url?|

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 Body

The connector slot after the change

application/json
  1. response

The result of registering, rotating, or removing a customer-owned Google OAuth client.

data*

The connector slot after the change

Example Request
cURL
curl -X PUT https://api.mixedbread.com/v1/integrations/oauth-clients/gmail \  -H 'Content-Type: application/json' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -d '{    "client_id": "123456789012-abcdefghijklmnop.apps.googleusercontent.com",    "client_secret": "GOCSPX-…",    "return_url": "https://platform.example.com/connected"  }'
Example Response
{  "data": {    "slot": {      "provider": "gmail",      "redirect_uri": "https://api.mixedbread.com/v1/integrations/gmail/oauth/callback",      "required_scopes": [        "https://www.googleapis.com/auth/gmail.readonly"      ],      "app_manifest": null,      "client": {        "provider": "gmail",        "client_id": "123456789012-abcdefghijklmnop.apps.googleusercontent.com",        "redirect_uri": "https://api.mixedbread.com/v1/integrations/gmail/oauth/callback",        "return_url": "https://platform.example.com/connected",        "has_signing_secret": false,        "created_by_user_id": "da5f646d-4827-49a5-92cc-2f16a6594c27",        "created_at": "2026-09-05T17:25:12.338038+00:00",        "updated_at": "2026-09-05T17:25:12.338038+00:00"      }    },    "reauth_required_installation_ids": [],    "disconnected_installation_ids": []  }}