API Reference
MarketplacePartnersBlogPerk →

Create select options

post
https://api.perk.com/custom-fields//select-options
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Creates one or more new single-select or multi-select options for a custom field. This endpoint is create-only; it doesn't update any options that already exist as active.

If any of the values passed fail validation or conflict with an existing active option, none of the options will be created. A value matching an existing archived option is unarchived and updated, rather than creating a duplicate.

Path Params
string
required

The unique ID of the custom field. Must be a select or multi-select field with target 'BOOKING'.

Body Params
select_options
array of objects
required
length ≥ 1

The options to create as an array, in the order they should be returned in the response.

select_options*
string
required

The option's display value. Must not be empty or whitespace-only, and must not exceed 160 characters.

string | null

The option's ERP code. Optional when the custom field does not have cost allocation enabled. Required when cost allocation is enabled. An empty or whitespace-only value counts as missing.

Headers
string
required

Your Perk API key, using the format 'ApiKey <your_api_key>'

string
required

The API version for this request. Must be '1'.

Responses

401

Returns '401 Unauthorized' when the Authorization header is missing or the API key is invalid. This response has no body.

Updated about 5 hours ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 5 hours ago

Did this page help you?