---
title: Create a Configuration
framework: Apple Business API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple business api 2.5+]
path: applebusinessapi/create-a-configuration
---

# Create a Configuration

Create a new custom Configuration in an organization.

## URL

POST https://api-business.apple.com/v1/configurations

## Response Codes

201 Created: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 409 Conflict: Request entity error(s). 422 : Unprocessable request entity error(s). 429 : Too Many Requests

## Overview

Overview important: Only Configurations with type CUSTOM_SETTING can be created with the API. note: configurationProfile is required. filename is optional — if omitted, a default filename is generated from the Configuration ID. configuredForPlatforms is optional — if omitted, supported platforms are auto-detected from the payload content in the Configuration profile. The profile must be compatible with the resolved platforms. Example

## Topics

### Responses

- [ConfigurationResponse](applebusinessapi/configurationresponse.md)

## See Also

### Configurations

- [Get Configurations](applebusinessapi/get-configurations.md)
- [Get Configuration Information](applebusinessapi/get-configuration-information.md)
- [Update a Configuration](applebusinessapi/update-a-configuration.md)
- [Delete a Configuration](applebusinessapi/delete-a-configuration.md)