---
title: "Create account SSO configuration"
method: POST
path: "/v2/authn/sso-config/accounts"
tags: ["SSO Configuration"]
---

# Create account SSO configuration

`POST /v2/authn/sso-config/accounts`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/authn/sso-config/accounts`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/authn/sso-config/accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new SSO configuration for an account to enable SAML-based authentication.

## Request body

- SSOConfigCreateRequest
  - `partitionId` string: Partition identifier. Required for partition-enforced/partition SSO configurations.
  - `accountId` string: Account identifier. Required for account-level SSO configurations.
  - `ssoName` string, required: SSO configuration name.

## Response `201`

SSO configuration created successfully

- SSOConfigCreateResponse
  - `scope` 'ACCOUNT_LEVEL_SSO' | 'PARTITION_ENFORCED_SSO' | 'PARTITION_SSO'
  - `scopeId` string
  - `ssoName` string
  - `assertionConsumerResponseUrl` string, uri
  - `serviceProviderEntityId` string
  - `serviceProviderSigningCertificate` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400`: Bad Request - Invalid request parameters or validation failed
- `401`: Unauthorized - Invalid or missing X-Auth-Token
- `404`: Not Found - Account or partition not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/7223246c352c?raw)