---
title: "Create SSO connector"
method: POST
path: "/api/sso-connectors"
tags: ["SSO connectors"]
---

# Create SSO connector

`POST /api/sso-connectors`

Create an new SSO connector instance for a given provider.

## Request body

- object
  - `config` object — arbitrary
  - `domains` string[]
  - `branding` object
    - `displayName` string
    - `logo` string
    - `darkLogo` string
  - `syncProfile` boolean
  - `enableTokenStorage` boolean
  - `providerName` string, required
  - `connectorName` string, required

## Response `200`

The created SSO connector.

- object
  - `tenantId` string, required
  - `id` string, required
  - `providerName` string, required
  - `connectorName` string, required
  - `config` object, required — arbitrary
  - `domains` string[], required
  - `branding` object, required
    - `displayName` string
    - `logo` string
    - `darkLogo` string
  - `syncProfile` boolean, required
  - `enableTokenStorage` boolean, required
  - `createdAt` number, required

## Other responses

- `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.

---

[API](https://skmtc.net/logto/apis/logto-api-references.md) · [All operations](https://skmtc.net/logto/apis/logto-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/logto/logto-api-references/revisions/a163dc77d842/schema)