Skip to main content
Create and manage enterprise SSO connections for your customers.

Endpoints

List connections

Retrieve all SSO connections for an organization.
GET /api/v1/organizations/{organizationId}/connections
Response:
{
  "connections": [
    {
      "id": "conn_1234567890",
      "type": "SAML",
      "provider": "okta",
      "status": "active",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ]
}

Create connection

Create a new SSO connection.
POST /api/v1/organizations/{organizationId}/connections
Request body:
{
  "type": "SAML",
  "provider": "okta",
  "enabled": true
}

Get connection

Retrieve a specific connection.
GET /api/v1/connections/{connectionId}

Update connection

Update connection configuration.
PATCH /api/v1/connections/{connectionId}

Delete connection

Remove an SSO connection.
DELETE /api/v1/connections/{connectionId}

Next steps

SAML configuration

SAML connection setup

OIDC configuration

OIDC connection setup

Build docs developers (and LLMs) love