POST

Create Customization


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a customization.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Stores - all permissions
Manage Products
Manage v3 catalog
Customization write in v3 catalog
Product write in v3 catalog
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v3/customizations

Body Params
customizationCustomizationRequired

Customization to create.

Response Object
customizationCustomization

Created customization.

Creates a customization with a text choices option

Request
cURL
curl -X POST \ 'https://www.wixapis.com/stores/v3/customizations' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ -d '{ "customization": { "customizationRenderType": "TEXT_CHOICES", "customizationType": "PRODUCT_OPTION", "name": "Size", "choicesSettings": { "choices": [ { "choiceType": "CHOICE_TEXT", "name": "Small" }, { "choiceType": "CHOICE_TEXT", "name": "Medium" }, { "choiceType": "CHOICE_TEXT", "name": "Large" } ] } } }'
Response
JSON
{ "customization": { "id": "8de17a9a-d6b2-4ec9-a088-ce79d6ef38c7", "revision": "1", "createdDate": "2024-06-26T09:35:15.526Z", "updatedDate": "2024-06-26T09:35:15.526Z", "key": "Size", "name": "Size", "customizationType": "PRODUCT_OPTION", "customizationRenderType": "TEXT_CHOICES", "choicesSettings": { "choices": [ { "id": "6d3aa7cc-f6c3-4516-ab2d-9099cb46d693", "choiceType": "CHOICE_TEXT", "key": "Small", "name": "Small", "assignedProductsCount": 0 }, { "id": "eb0285fd-2a42-44c4-b113-8c111ead2ca2", "choiceType": "CHOICE_TEXT", "key": "Medium", "name": "Medium", "assignedProductsCount": 0 }, { "id": "66e4c999-8dbb-4a1a-b8ee-c7de1f24e4eb", "choiceType": "CHOICE_TEXT", "key": "Large", "name": "Large", "assignedProductsCount": 0 } ] } } }
Errors
400Invalid Argument

There is 1 error with this status code.

428Failed Precondition

There are 3 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?