Mar 9

Create and manage enterprise connections through Clerk's API

Category: API
Published: Mar 9

Create, list, read, update, and delete enterprise connections programmatically.

You can now fully manage both SAML and OIDC enterprise connections via the Clerk Backend API. Previously, you could only manage SAML connections via the API.

What's new

The following endpoints are now available on Clerk's backend API:

Method	Path	Description
`POST`	`/v1/enterprise_connections`	Create an enterprise connection. Accepts `provider`, `domains`, `name` and `organization_id` as params
`GET`	`/v1/enterprise_connections`	List enterprise connections. Query: `organization_id` (optional), pagination.
`GET`	`/v1/enterprise_connections/{enterpriseConnectionID}`	Get a single enterprise connection.
`PATCH`	`/v1/enterprise_connections/{enterpriseConnectionID}`	Update an enterprise connection.
`DELETE`	`/v1/enterprise_connections/{enterpriseConnectionID}`	Delete an enterprise connection.

If you currently use the /saml_connections endpoint, we recommend migrating to the new /enterprise_connections endpoint. This unified API allows you to manage both SAML and OIDC connections, and will serve as the primary interface moving forward. Support for the legacy SAML endpoint may be phased out in the future.

Getting started

Visit the API reference for detailed documentation on request parameters and response formats.