---
title: "Create a new identity provider"
method: POST
path: "/api/organizations/{organizationId}/identityproviders"
tags: ["IdentityProviders"]
---

# Create a new identity provider

`POST /api/organizations/{organizationId}/identityproviders`

Creates a new identity provider for the specified organization.

## Path parameters

- `organizationId` string, uuid, required

## Request body

- IdentityProvider — Information about an identity provider.
  - `id` string, uuid — Unique identifier for the identity provider.
  - `name` string, nullable — Name of the identity provider.
  - `description` string, nullable — Description of the identity provider.
  - `organizationId` string, uuid — Unique identifier for the organization.
  - `crosserRole` string, nullable — The role required in the identity provider that external users must have to log in to the Crosser system.
  - `clientId` string, nullable — Client ID for the identity provider.
  - `clientSecret` string, nullable — Client secret for the identity provider.
  - `callbackPath` string, nullable — Callback path for the identity provider.
  - `authority` string, nullable — Authority URL for the identity provider.
  - `userNameClaim` string, nullable — Claim used for the username.
  - `disabled` boolean — Indicates if the identity provider is disabled.
  - `debug` boolean — Indicates if debug mode is enabled.
  - `getClaimsFromUserInfoEndpoint` boolean — Indicates if claims should be retrieved from the user info endpoint.
  - `domains` string[], nullable — List of domains associated with the identity provider.
  - `scopes` string[], nullable — List of scopes for the identity provider.
  - `roleClaims` string[], nullable — List of role claims for the identity provider.
  - `roleMappings` object, nullable — Dictionary of role mappings for the identity provider.

## Response `200`

OK

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `503` — Service Unavailable

---

[API](https://skmtc.dev/crosser/apis/edge-director-api.md) · [All operations](https://skmtc.dev/crosser/apis/edge-director-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crosser/edge-director-api/revisions/746b3f44e69d/schema)