---
title: "POST /identity-provider"
method: POST
path: "/identity-provider"
tags: ["auth"]
---

# POST /identity-provider

`POST /identity-provider`

Add an identity provider configuration for a team

## Request body

- object
  - `name` string, required
  - `issuer` string — This is the URI that identifies your SAML identity provider. Any assertions must use a matching <saml:Issuer> attribute.
  - `ssoUrl` string — This URL is used by Scalar to initiate a SAML login.
  - `x509Cert` string — The authentication certificate issued by your identity provider
  - `provider` 'local' | 'google' | 'okta' | 'auth0' | 'azure' | 'one-login' | 'ping-identity', required
  - `signRequests` boolean
  - `consumerOnly` boolean, required
  - `createUsers` boolean

## Response `200`

Default Response

- IdentityProviderRecord
  - `uid` string, required
  - `createdAt` integer, required
  - `updatedAt` integer, required
  - `name` string, required
  - `provider` 'local' | 'google' | 'okta' | 'auth0' | 'azure' | 'one-login' | 'ping-identity', required
  - `createUsers` boolean, required
  - `signRequests` boolean, required
  - `ssoUrl` string, required — This URL is used by Scalar to initiate a SAML login.
  - `issuer` string, required — This is the URI that identifies your SAML identity provider. Any assertions must use a matching <saml:Issuer> attribute.
  - `x509Cert` string, required — The authentication certificate issued by your identity provider
  - `consumerOnly` boolean, required

## Other responses

- `400` — Bad request
- `401` — No auth
- `403` — Forbidden
- `404` — Not found
- `422` — Invalid payload
- `500` — Uncaught error

---

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