Skip to main content
POST
Create storefront

Authorizations

Authorization
string
header
required

Marea API key. mk_dev_* keys are developer-scoped (bootstrap, list users, register webhook). mk_user_* keys are user-scoped (manage that one user's storefronts/products). Scopes: catalog:read, catalog:write, storefront:publish, me:verify, me:resendVerification, developer:bootstrap, developer:read, developer:issueUserKey, developer:webhooks.

Headers

Idempotency-Key
string

Optional client-supplied key. Replays of the same key within 24h return the original response. Recommended for POSTs that mutate billing/inventory.

Maximum string length: 200
Example:

"idem_b2a9f5b9-3e0c-4a5e-b3c2-7a4ce85a6b21"

Accept-Language
string

BCP-47 locale tag for localized error messages (es, en, pt). Defaults to es.

Example:

"es-MX"

Body

application/json

Request body.

Agent-facing storefront input shape (RFC §6.18.1). Every field is PATCHable per §6.18.1.1.

name
string
required
Required string length: 1 - 100
language
enum<string>
required
Available options:
es,
en,
pt
currency
string
required
Pattern: ^[A-Z]{3}$
businessType
string
required
branding
object | null
schedule
object | null
delivery
object | null
pickup
boolean | null
dineIn
boolean | null
whatsapp
string | null
biography
blocks
Available options:
auto
categories
object[] | null
products
object[] | null
Maximum array length: 100

Response

Resource created.

storefront
object
required
errors
object[]