---
title: "Create SSO provider configuration for organization"
method: POST
path: "/organizations/{organizationId}/ssoProvider"
tags: ["Organizations"]
---

# Create SSO provider configuration for organization

`POST /organizations/{organizationId}/ssoProvider`

## Path parameters

- `organizationId` string, required

## Request body

- SsoProviderCreateRequest
  - `clientId` string, required — Client ID for the SSO provider
  - `clientSecret` string, required — Client secret for the SSO provider
  - `ssoDomain` string, required — SSO domain for the provider
  - `emailDomain` string, required — Email domain for the company emails to be used for SSO
  - `provider` 'okta', required

## Response `201`

Successfully created SSO provider configuration

- SsoProvider
  - `id` string, required
  - `clientId` string, required — Client ID for the SSO provider
  - `maskedClientSecret` string, required — Masked client secret for the SSO provider
  - `organizationId` string, required
  - `ssoDomain` string, required — SSO domain for the provider
  - `emailDomain` string, required — Email domain for the company emails to be used for SSO
  - `provider` 'okta', required
  - `redirectUrl` string — Redirect URL for the SSO provider
  - `enforceOnlySSO` boolean, required — Whether SSO is enforced for this domain
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `ssoDomainVerifiedAt` string, date-time — Timestamp when the SSO domain was verified by Dynamic API. This will be present when the SSO domain ownership has been verified by setting a TXT record in DNS.
  - `ssoDomainVerificationChallenge` string — TXT record challenge string for the SSO domain verification. This will be provided when the SSO provider domain ownership needs to be verified by setting a TXT record in DNS.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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