List SSO connections

List SSO connections
Stable

Request

Lists the SSO connections configured for a tenant. Use it to see every SAML or OIDC identity provider connection set up for the enterprise, along with which one is marked as default.

Returns a count and an array of connections, each with its connection ID and connection details (name, strategy, is_default). Supports filtering by is_default.

About SSO Connections

SSO connections let a tenant authenticate users through an external identity provider using SAML (samlp) or OIDC (oidc) rather than Esper's native login. A tenant can have multiple connections configured, with one designated as the default. Learn more.

Key Fields / Query Parameters

is_default — optional query filter to return only the connection marked as default
strategy — indicates whether a connection is samlp (SAML) or oidc (OIDC)

Common Use Cases

Auditing which identity providers are connected to a tenant
Looking up a connection_id before calling the edit-connection endpoint List SSO connections of a tenant. Learn more about SSO Connections.

Security

esper_cloud_api_apiKey

Path

enterprise_idstring, (uuid)required

Enterprise ID

Query

is_defaultboolean

Is Default

cURL

curl -i -X GET \
  'https://api.esper.io/_mock/openapi/authn2/v0/tenant/{enterprise_id}/connection?is_default=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Tenant connections

Bodyapplication/json

countinteger

connectionsArray of objects(CustomConnectionsListResponse)

Response

{
  "count": 0,
  "connections": [
    { … }
  ]
}