Logto API references

Create SSO connector

POST /api/sso-connectors

Create an new SSO connector instance for a given provider.

application/json

Body Required

config object

arbitrary
domains array[string]
branding object
Hide branding attributes Show branding attributes
- displayName string
- logo string
- darkLogo string
syncProfile boolean
providerName string Required

Minimum length is 1, maximum length is 128.
connectorName string Required

Minimum length is 1, maximum length is 128.

Responses

• 200 application/json

The created SSO connector.
Hide response attributes Show response attributes object
- id string Required
  
  Minimum length is 1, maximum length is 128.
- providerName string Required
  
  Minimum length is 1, maximum length is 128.
- connectorName string Required
  
  Minimum length is 1, maximum length is 128.
- config object Required
  
  arbitrary
- domains array[string] Required
- branding object Required
  
  Hide branding attributes Show branding attributes
  
  displayName string
  
  logo string
  
  darkLogo string
- syncProfile boolean Required
- createdAt number Required
• 400

Bad Request
• 401

Unauthorized
• 403

Forbidden
• 409

Conflict
• 422

At lease one of the given input fields is invalid or IdP connection cannot be verified with the given config.

POST /api/sso-connectors

curl \
 -X POST https://[tenant_id].logto.app/api/sso-connectors \
 -H "Content-Type: application/json" \
 -d '{"config":{},"domains":["string"],"branding":{"displayName":"string","logo":"string","darkLogo":"string"},"syncProfile":true,"providerName":"string","connectorName":"string"}'

Request example

{
  "config": {},
  "domains": [
    "string"
  ],
  "branding": {
    "displayName": "string",
    "logo": "string",
    "darkLogo": "string"
  },
  "syncProfile": true,
  "providerName": "string",
  "connectorName": "string"
}

Response examples (200)

{
  "id": "string",
  "providerName": "string",
  "connectorName": "string",
  "config": {},
  "domains": [
    "string"
  ],
  "branding": {
    "displayName": "string",
    "logo": "string",
    "darkLogo": "string"
  },
  "syncProfile": true,
  "createdAt": 42.0
}