Skip to main content
POST
/
channel-api
/
v1.0
/
shops
Create a shop
curl --request POST \
  --url https://api.fourthwall.com/channel-api/v1.0/shops \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "ownerEmail": "<string>"
}
'
{
  "shopId": "<string>",
  "shopName": "<string>",
  "publicToken": "<string>",
  "invitationEmail": "<string>",
  "invitationStatus": "<string>",
  "payoutOnboardingUrl": "<string>"
}
This endpoint is in beta and subject to change.

Body

application/json
​
name
string
required

Display name for the new shop.

​
ownerEmail
string

Email to invite as the shop owner. When set, an owner invitation is sent. Also used as the payout account email when payout.prefill.individual.email is absent.

​
payout
Payout X Request · object

Optional payout onboarding. When present, a connected payout account is provisioned for the shop and a hosted onboarding URL is returned as payoutOnboardingUrl.

Response

201 - application/json

Created

​
shopId
string
required

Id of the newly created shop.

​
shopName
string
required

Display name of the created shop.

​
publicToken
string
required

Public storefront token for the shop.

​
invitationEmail
string

Email the owner invitation was sent to, if ownerEmail was provided.

​
invitationStatus
string

Status of the owner invitation (e.g. INVITED, FAILED), or null when no email was provided.

​
payoutOnboardingUrl
string

Hosted payout onboarding URL to redirect the creator to. Present only when payout was supplied. Single-use and short-lived.