---
title: "Create a shop"
method: POST
path: "/channel-api/v1.0/shops"
tags: ["Shops"]
---

# Create a shop

`POST /channel-api/v1.0/shops`

## Request body

- ComFourthwallAppChannelShopModelCreateShopXRequest
  - `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` ComFourthwallAppChannelShopModelPayoutXRequest
    - `returnUrl` string, required — HTTPS URL the creator is redirected back to when they leave the hosted payout onboarding (whether or not they finished). Returning here does NOT mean the account is ready — verify account status separately.
    - `refreshUrl` string, required — HTTPS URL the creator is redirected to when the onboarding link is no longer usable (expired or reused). The integration is expected to mint a fresh link and redirect again.
    - `country` string — Two-letter ISO country code for the payout account (e.g. `US`). Determines supported currencies and the verification fields required.
    - `businessType` string — Payout account business type: `individual` or `company`.
    - `prefill` ComFourthwallAppChannelShopModelPayoutPrefillXRequest
      - `businessProfile` ComFourthwallAppChannelShopModelBusinessProfilePrefillXRequest
        - `name` string — Business or brand name.
        - `url` string — Business website URL.
        - `productDescription` string — Short description of what the business sells.
        - `mcc` string — Merchant category code (4-digit MCC).
        - `supportEmail` string — Customer support email address.
        - `supportPhone` string — Customer support phone number, in E.164 format.
        - `supportUrl` string — Customer support URL.
      - `individual` ComFourthwallAppChannelShopModelIndividualPrefillXRequest
        - `firstName` string — Legal first name.
        - `lastName` string — Legal last name.
        - `email` string — Personal email address.
        - `phone` string — Phone number, in E.164 format.
        - `dobDay` integer — Date of birth — day of month (1-31).
        - `dobMonth` integer — Date of birth — month (1-12).
        - `dobYear` integer — Date of birth — four-digit year.
        - `addressLine1` string — Street address line 1.
        - `addressLine2` string — Street address line 2.
        - `addressCity` string — Address city.
        - `addressState` string — Address state / province / region.
        - `addressPostalCode` string — Address postal / ZIP code.
        - `addressCountry` string — Two-letter ISO country code for the address.
        - `ssnLast4` string — Last 4 digits of the individual's US SSN.
        - `idNumber` string — Government-issued ID number (e.g. full SSN) where full verification is required.
      - `company` ComFourthwallAppChannelShopModelCompanyPrefillXRequest
        - `name` string — Registered legal company name.
        - `addressLine1` string — Company address line 1.
        - `addressLine2` string — Company address line 2.
        - `addressCity` string — Company address city.
        - `addressState` string — Company address state / province / region.
        - `addressPostalCode` string — Company address postal / ZIP code.
        - `addressCountry` string — Two-letter ISO country code for the company address.
        - `taxId` string — Business tax ID (e.g. US EIN).
        - `vatId` string — VAT identification number, where applicable.
        - `registrationNumber` string — Company registration number, where applicable.
        - `structure` string — Legal company structure (e.g. `sole_proprietorship`, `private_corporation`).
      - `externalAccount` string — Bank account token to receive payouts (e.g. a tokenized bank account such as a `btok_…`).

## Response `201`

Created

- ComFourthwallAppChannelShopModelCreateShopXResponse
  - `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.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-3.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-3/revisions/ebc29b226337/schema)