# Create a Configuration Create a new custom Configuration in an organization. ## 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 **Request:** ``` curl -X POST "https://api-business.apple.com/v1/configurations" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "Content-Type: application/json" \ -d '{ "data": { "type": "configurations", "attributes": { "type": "CUSTOM_SETTING", "name": "AirPlay Security Settings", "configuredForPlatforms": ["PLATFORM_IOS"], "customSettingsValues": { "configurationProfile": "PayloadContentAccessTypeWIFI_ONLYPayloadTypecom.apple.airplay.security", "filename": "Airplay.mobileconfig" } } } }' ``` **Response:** ```json { "data": { "type": "configurations", "id": "config-new-456", "attributes": { "type": "CUSTOM_SETTING", "name": "AirPlay Security Settings", "configuredForPlatforms": [ "PLATFORM_IOS" ], "customSettingsValues": { "configurationProfile": "...", "filename": "Airplay.mobileconfig" }, "createdDateTime": "2024-06-15T10:30:00Z", "updatedDateTime": "2024-06-15T10:30:00Z" }, "links": { "self": "https://api-business.apple.com/v1/configurations/config-new-456" } }, "links": { "self": "https://api-business.apple.com/v1/configurations/config-new-456" } } ``` ## Topics ### Responses [`object ConfigurationResponse`](/documentation/AppleBusinessAPI/ConfigurationResponse) A response that contains information about a Configuration resource. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)