Skip to main content
POST
cURL
Create a reusable market without attaching it to a plan or price. Countries can belong to only one active market.

Authorizations

x-api-key
string
header
required

Headers

Idempotency-Key
string

Unique key used to safely retry this write for 24 hours without applying it twice.

Required string length: 1 - 200
Commet-Version
string
default:2026-08-27

API version used by this reference. Send this header to select this contract explicitly.

Body

application/json
name
string
required
Minimum string length: 1
countryCodes
string[]
required
Minimum array length: 1
Required string length: 2
metadata
object

Response

Success

id
string
required
name
string
required
countryCodes
string[]
required
metadata
object
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
object
string
required
Allowed value: "market"
livemode
boolean
required