Create Workspace Auth Connection | ElevenLabs Documentation

curl -X POST https://api.elevenlabs.io/v1/workspace/auth-connections \
     -H "xi-api-key: xi-api-key" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "GitHub OAuth2 Connection",
  "provider": "github",
  "client_id": "abc123xyz456",
  "token_url": "https://github.com/login/oauth/access_token",
  "client_secret": "s3cr3tG1thUbCl13ntS3cr3t"
}'

{
  "auth_type": "oauth2_client_credentials",
  "client_id": "abc123xyz456",
  "id": "d4f5e6a7-b8c9-0123-4567-89abcdef0123",
  "name": "GitHub OAuth2 Connection",
  "provider": "github",
  "token_url": "https://github.com/login/oauth/access_token",
  "basic_auth_in_header": false,
  "extra_params": {},
  "scopes": [
    "repo",
    "user"
  ],
  "used_by": {
    "tools": [
      {
        "type": "available",
        "access_level": "admin",
        "created_at_unix_secs": 1685000000,
        "id": "tool-987654321",
        "name": "CI/CD Pipeline"
      }
    ],
    "mcp_servers": [
      {
        "type": "available",
        "access_level": "admin",
        "created_at_unix_secs": 1684000000,
        "id": "server-123456789",
        "name": "Main MCP Server"
      }
    ],
    "integration_connections": [
      {
        "id": "integration-456789123",
        "name": "Jira Integration"
      }
    ]
  }
}

Create a new OAuth2 auth connection for the workspace

Request

This endpoint expects an object.

CreateOAuth2ClientCredsRequestobjectRequired

CreateCustomHeaderAuthRequestobjectRequired

CreateBasicAuthRequestobjectRequired

CreateOAuth2JWTRequestobjectRequired

CreatePrivateKeyJWTRequestobjectRequired

CreateMTLSAuthRequestobjectRequired

Response

Successful Response

oauth2_client_credentialsobject

Response model for oauth2 client creds

basic_authobject

Response model for basic auth

bearer_authobject

Response model for bearer auth

oauth2_jwtobject

Response model for OAuth2 JWT auth connections

private_key_jwtobject

Response model for Private Key JWT auth connections

mtlsobject

Response model for mTLS auth connections.

custom_header_authobject

Response model for Custom Header Auth auth connections

api_integration_oauth2_auth_codeobject

Response model for integration-managed OAuth2 Auth Code auth connections

whatsapp_authobject

Errors

422

Unprocessable Entity Error

Headers

Request

Response

Errors