# Create a federated identity provider for the current billing client

Configures a SAML 2.0 federated identity provider (IdP) in the Cognito user pool that
belongs to the current billing client, and updates the Elevate app client to use that
provider exclusively.

Endpoint: POST /identity-providers
Version: 1.6
Security: bearerAuth

## Request fields (application/json):

  - `providerName` (string, required)

  - `providerType` (string, required)
    Enum: "SAML"

  - `metadataUrl` (string, required)

  - `attributeMapping` (object, required)
    Maps standard Cognito user attributes to the SAML claim URIs that your external IdP
includes in its SAML assertion.

  - `attributeMapping.email` (string, required)
    SAML claim URI that carries the user's email address.
    Example: "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"

  - `attributeMapping.given_name` (string, required)
    SAML claim URI that carries the user's first name.
    Example: "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname"

  - `attributeMapping.family_name` (string, required)
    SAML claim URI that carries the user's last name (surname).
    Example: "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname"

## Response 201 fields (application/json):

  - `billingClientId` (integer, required)

  - `providerName` (string, required)

  - `providerType` (string, required)
    Enum: "SAML"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields