# Create SAML application

**POST /api/saml-applications**

Create a new SAML application with the given configuration. A default signing certificate with 3 years lifetime will be automatically created.


## Servers
- Logto endpoint address.: https://[tenant_id].logto.app (Logto endpoint address.)


## Authentication methods
- O auth2


## Parameters



## Body parameters
Content-type: application/json

- **name** (string)
  The name of the SAML application.
- **description** (string | null)
  Optional description of the SAML application.
- **customData** (object)
  Optional custom data for the application.
- **attributeMapping** (object)
  
- **entityId** (string | null)
  
- **acsUrl** (string | null)
  The Assertion Consumer Service (ACS) URL where the SAML response will be sent.
- **encryption** (object | null)
  Validator function
- **nameIdFormat** (string)
  

## Responses
### 201: The SAML application was created successfully.

#### Body Parameters: application/json (object)
- **tenantId** (string)
  
- **id** (string)
  
- **name** (string)
  
- **description** (string | null)
  
- **type** (string)
  
- **customData** (object)
  arbitrary
- **isThirdParty** (boolean)
  
- **createdAt** (number)
  
- **attributeMapping** (object)
  
- **entityId** (string | null)
  
- **acsUrl** (object | null)
  
- **encryption** (object | null)
  Validator function
- **nameIdFormat** (string)
  

### 400: Invalid request body.

### 401: Unauthorized

### 403: Forbidden

### 422: Validation error. The ACS URL is invalid or other validation errors.


[Powered by Bump.sh](https://bump.sh)