How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Auth0 connections API

The connections API from Auth0 — 15 operation(s) for connections.

Auth0 connections API is one of 76 APIs that Auth0 publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Connections. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and an AsyncAPI specification.

This API exposes 28 operations across 15 paths, and defines 108 schemas. It is described by OpenAPI 3.2.0, at version 2.0.

Requests are made against a single base URL, https://{tenantDomain}/api/v2.

28 operations 15 paths 108 schemas 5 DELETE11 GET4 PATCH7 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0
Base URL
https://your-tenant.auth0.com/api/v2
Authentication
HTTP Bearer, OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 2

Auth0 connections API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (jwt) (bearerAuth). It supports OAuth 2.0 (oAuth2ClientCredentials) using the clientCredentials flow, exposing 221 scopes. By default, every request must be authenticated.

Paths & Operations 28

Across 15 paths, the API surfaces 28 operations — 5 DELETE, 11 GET, 4 PATCH, 7 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

connections 28
GET
/connections
Get All Connections
get_connections 9 params → 200400401403429
POST
/connections
Create a Connection
post_connections body → 201400401403409429
GET
/connections/{id}
Get a Connection
get_connections_by_id 3 params → 200400401403404429
DELETE
/connections/{id}
Delete a Connection
delete_connections_by_id 1 param → 202204400401403429
PATCH
/connections/{id}
Update a Connection
patch_connections_by_id 1 param body → 200400401403404409429
GET
/connections/{id}/clients
Get Enabled Clients for a Connection
get_connection_clients 3 params → 200400401403404429
PATCH
/connections/{id}/clients
Update Enabled Clients for a Connection
patch_clients 1 param body → 204400401403404429
GET
/connections/{id}/directory-provisioning
Get a Directory Provisioning Configuration
get_directory-provisioning 1 param → 200400401403404429
DELETE
/connections/{id}/directory-provisioning
Delete a Directory Provisioning Configuration
delete_directory-provisioning 1 param → 204400401403404429
PATCH
/connections/{id}/directory-provisioning
Patch a Directory Provisioning Configuration
patch_directory-provisioning 1 param body → 200400401403404429
POST
/connections/{id}/directory-provisioning
Create a Directory Provisioning Configuration
post_directory-provisioning 1 param body → 201400401403404409429
GET
/connections/{id}/directory-provisioning/default-mapping
Get a Connection's Default Directory Provisioning Attribute Mapping
get_directory_provisioning_default_mapping 1 param → 200400401403404429
POST
/connections/{id}/directory-provisioning/synchronizations
Request an On-demand Synchronization of the Directory
post_synchronizations 1 param → 201400401403404409429
GET
/connections/{id}/directory-provisioning/synchronized-groups
Get Synchronized Groups for a Directory Provisioning Configuration
get_synchronized-groups 3 params → 200400401403404429
PUT
/connections/{id}/directory-provisioning/synchronized-groups
Create or Replace Synchronized Group Selections for a Directory Provisioning Configuration
put_synchronized-groups 1 param body → 204400401403404409429
GET
/connections/{id}/keys
Get Connection Keys
get_keys 1 param → 200400401403404429
POST
/connections/{id}/keys
Create Connection Keys
post_keys 1 param body → 201400401403404409429
POST
/connections/{id}/keys/rotate
Rotate Connection Keys
post_rotate 1 param body → 201400401403404429
GET
/connections/{id}/scim-configuration
Get a Connection's SCIM Configuration
get_scim-configuration 1 param → 200400404
DELETE
/connections/{id}/scim-configuration
Delete a Connection's SCIM Configuration
delete_scim-configuration 1 param → 204400404
PATCH
/connections/{id}/scim-configuration
Patch a Connection's SCIM Configuration
patch_scim-configuration 1 param body → 200400404
POST
/connections/{id}/scim-configuration
Create a SCIM Configuration
post_scim-configuration 1 param body → 201400404
GET
/connections/{id}/scim-configuration/default-mapping
Get a Connection's Default SCIM Mapping
get_default-mapping 1 param → 200400404
GET
/connections/{id}/scim-configuration/tokens
Get a Connection's SCIM Tokens
get_scim_tokens 1 param → 200400404
POST
/connections/{id}/scim-configuration/tokens
Create a SCIM Token
post_scim_token 1 param body → 201400404409
DELETE
/connections/{id}/scim-configuration/tokens/{tokenId}
Delete a Connection's SCIM Token
delete_tokens_by_tokenId 2 params → 204400404
GET
/connections/{id}/status
Check Connection Status
get_status 1 param → 200400401403404429
DELETE
/connections/{id}/users
Delete a Connection User
delete_users_by_email 2 params → 204400401403429

Schemas 108

The contract defines 108 schemas that model the data the API accepts and returns. The most detailed are UpdateConnectionOptions (36 properties), ConnectionPropertiesOptions (36 properties), CreateConnectionResponseContent (12 properties), ConnectionKey (12 properties). Each schema is shown below with its type and property counts.

ConnectionSignupBehaviorEnum
string
Specifies the signup behavior for password authentication
GetConnectionResponseContent
object
12 properties
ConnectionOptions
object
In order to return options in the response, the read:connectionsoptions scope must be present
ConnectionEmailOtpAuthenticationMethod
object
Email OTP authentication enablement
1 property
UpdateConnectionResponseContent
object
12 properties
GetScimTokensResponseContent
array
The list of scim tokens for scim clients
CreateDirectorySynchronizationResponseContent
object
3 properties 3 required
ConnectionValidationOptions
objectnull
Options for validation
1 property
ConnectionFederatedConnectionsAccessTokens
objectnull
Federated Connections Access Tokens
1 property
ConnectionIdentifierPrecedenceEnum
string
Order of precedence for attribute types
ConnectionPhoneOtpAuthenticationMethod
object
Phone OTP authentication enablement
1 property
ConnectionUpstreamAlias
object
1 property
PostConnectionsKeysResponseContent
array
CreateScimTokenResponseContent
object
5 properties
PasswordDefaultDictionariesEnum
string
Default dictionary to use for password validation. Options: "en10k" (10,000 common words) or "en100k" (100,000 common words)
ScimTokenItem
object
5 properties
SynchronizedGroupPayload
object
1 property 1 required
ConnectionPropertiesOptions
object
The connection's options (depend on the connection strategy)
36 properties
ListConnectionsCheckpointPaginatedResponseContent
object
2 properties
UpdateConnectionRequestContent
object
9 properties
ConnectionApiBehaviorEnum
string
Specifies the API behavior for password authentication
PasswordCharacterTypeEnum
string
ConnectionUpstreamAliasEnum
string
ConnectionKeyUseEnum
string
Signing key use, whether for encryption or signing
PhoneAttribute
object
Configuration for the phone number attribute for users.
3 properties
ConnectionPasskeyChallengeUIEnum
string
Controls the UI used to challenge the user for their passkey.
ConnectionAuthenticationMethods
objectnull
Options for enabling authentication methods.
4 properties
CreateConnectionResponseContent
object
12 properties
CreateDirectoryProvisioningRequestContent
objectnull
3 properties
ConnectionPasswordOptionsDictionary
object
Dictionary-based password restriction policy to prevent common passwords
3 properties
ConnectionStrategyEnum
string
UsernameAttribute
object
Configuration for the username attribute for users.
4 properties
RotateConnectionsKeysResponseContent
object
9 properties 4 required
ConnectionAttributeIdentifier
object
2 properties
ScimMappingItem
object
2 properties
EmailAttribute
object
Configuration for the email attribute for users.
5 properties
UpdateConnectionOptions
objectnull
The connection's options (depend on the connection strategy). To update these options, the update:connectionsoptions scope must be present. To verify your chan…
36 properties
ConnectionPasswordNoPersonalInfoOptions
objectnull
Options for personal info in passwords policy
1 property 1 required
ConnectionPasswordPolicyEnum
stringnull
Password strength level
ConnectionForList
object
11 properties
ConnectionAttributes
object
Attribute configuration
3 properties
ConnectionIdentityProviderEnum
string
The identity provider identifier for the connection
ConnectionUpstreamParams
objectnull
Options for adding parameters in the request to the upstream IdP
SignupSchema
object
1 property
RotateConnectionKeysSigningAlgEnum
string
Selected Signing Algorithm
SignupVerified
object
2 properties
PasswordSequentialCharactersPolicyEnum
string
Controls whether sequential characters are allowed in passwords
SignupStatusEnum
string
CreateScimConfigurationResponseContent
object
8 properties 8 required
ConnectionsMetadata
object
Metadata associated with the connection in the form of an object with string values (max 255 chars). Maximum of 10 metadata properties allowed.
ConnectionUpstreamAdditionalProperties
object
GetDirectoryProvisioningDefaultMappingResponseContent
object
1 property
UpdateDirectoryProvisioningResponseContent
object
11 properties 7 required
ConnectionPasskeyOptions
objectnull
Options for the passkey authentication method
3 properties
ConnectionPasswordOptions
object
Password policy options for flexible password policy configuration
4 properties
VerificationMethodEnum
string
ListConnectionsResponseContent
ConnectionPasswordOptionsComplexity
object
Password complexity requirements configuration
6 properties
PasswordIdenticalCharactersPolicyEnum
string
Controls whether identical consecutive characters are allowed in passwords
ConnectionConnectedAccountsPurpose
object
Configure the purpose of a connection to be used for connected accounts and Token Vault.
2 properties 1 required
ConnectionPasswordDictionaryOptions
objectnull
Options for password dictionary policy
2 properties 1 required
ConnectionEnabledClient
object
1 property 1 required
ConnectionAuthenticationPurpose
object
Configure the purpose of a connection to be used for authentication during login.
1 property 1 required
GetConnectionEnabledClientsResponseContent
object
2 properties 1 required
GetScimConfigurationDefaultMappingResponseContent
object
1 property
ConnectionCustomScripts
object
A map of scripts used to integrate with a custom database.
9 properties
SynchronizeGroupsEnum
string
Group synchronization configuration
DirectoryProvisioningMappingItem
object
2 properties 2 required
UsernameValidation
object
3 properties
GetDirectoryProvisioningResponseContent
object
11 properties 7 required
UpdateScimConfigurationResponseContent
object
8 properties 8 required
GetScimConfigurationResponseContent
object
8 properties 8 required
ConnectionTokenEndpointJwtcaAudFormatEnumOIDC
string
Specifies the format of the aud (audience) claim included in the JWT used for client authentication at the token endpoint. Accepted values are: 'issuer' (the a…
UpdateScimConfigurationRequestContent
object
2 properties 2 required
ConnectionPasswordComplexityOptions
objectnull
Password complexity options
1 property
ConnectionUsernameValidationOptions
objectnull
2 properties 2 required
ListSynchronizedGroupsResponseContent
object
2 properties 1 required
CreateDirectoryProvisioningResponseContent
object
11 properties 7 required
ReplaceSynchronizedGroupsRequestContent
object
1 property 1 required
PostConnectionKeysRequestContent
objectnull
1 property
ConnectionAssertionDecryptionSettings
object
Settings for SAML assertion decryption.
2 properties 1 required
ConnectionIdTokenSignedResponseAlgEnum
string
Algorithm allowed to verify the ID tokens.
ConnectionUpstreamValue
object
1 property
ConnectionKey
object
12 properties 4 required
ConnectionGatewayAuthentication
objectnull
Token-based authentication settings to be applied when connection is using an sms strategy.
5 properties 3 required
ConnectionPasskeyAuthenticationMethod
object
Passkey authentication enablement
1 property
PasswordMaxLengthExceededPolicyEnum
string
Controls whether passwords that exceed the maximum length are truncated or rejected
ConnectionTokenEndpointAuthMethodEnum
stringnull
Authentication method used at the identity provider's token endpoint. 'clientsecretpost' sends credentials in the request body; 'privatekeyjwt' uses a signed J…
SignupVerification
object
1 property
ConnectionTokenEndpointAuthSigningAlgEnum
stringnull
Algorithm used to sign clientassertions.
ConnectionPasswordOptionsHistory
object
Password history policy configuration to prevent password reuse
2 properties
CreateScimConfigurationRequestContent
objectnull
2 properties
ConnectionPasswordOptionsProfileData
object
Personal information restriction policy to prevent use of profile data in passwords
2 properties
UpdateEnabledClientConnectionsRequestContent
array
CreateConnectionRequestContent
object
11 properties 2 required
DefaultMethodEmailIdentifierEnum
string
Default authentication method for email identifier
UpdateDirectoryProvisioningRequestContent
objectnull
3 properties
ConnectionPasswordHistoryOptions
objectnull
Options for password history policy
2 properties 1 required
ConnectionAssertionDecryptionAlgorithmProfileEnum
string
The algorithm profile to use for decrypting SAML assertions.
UsernameAllowedTypes
object
2 properties
PasswordCharacterTypeRulePolicyEnum
string
When enabled, passwords must contain at least 3 out of 4 character types. Can only be enabled when all 4 character types are specified
ListConnectionsOffsetPaginatedResponseContent
object
4 properties
PostConnectionKeysAlgEnum
string
Selected Signing Algorithm
ConnectionSetUserRootAttributesEnum
string
When using an external IdP, this flag determines whether 'name', 'givenname', 'familyname', 'nickname', and 'picture' attributes are updated. In addition, it a…
RotateConnectionKeysRequestContent
objectnull
1 property
CreateScimTokenRequestContent
object
SCIM Token
2 properties
ConnectionPasswordAuthenticationMethod
object
Password authentication enablement
3 properties
ConnectionIdTokenSignedResponseAlgs
arraynull
List of algorithms allowed to verify the ID tokens.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

auth0-connections-api-openapi.yml Raw ↑

Other APIs Auth0 publishes across the network.

Auth0 My Account API
Auth0 My Organization API
Auth0 for AI Agents
Auth0 actions API
Auth0 anomaly API
Auth0 Assertions API
Auth0 attack-protection API
Auth0 Authorization Models API
Auth0 Authorize User API
Auth0 AuthZenService API
Auth0 branding API
Auth0 client-grants API
Where this information came from

This is an independent, third-party profile of Auth0 connections API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.