---
title: "Create Seller"
method: POST
path: "/seller"
tags: ["marketplace"]
---

# Create Seller

`POST /seller`

Given the verification information, register a seller to a marketplace

## Request body

- union
  - SellerUsKybBody
    - `email` string, required
    - `onboardingToken` string — Server-signed onboarding token minted by the parent marketplace. The parent is derived from this token — it cannot be supplied directly. Not required when the request is authenticated with the marketplace's API key; the parent is then derived from the key.
    - `sellerId` string, required — MerchantId of the individual seller
    - `business` boolean, required
    - `info` KybInformation, required
      - `name` string, required — Name of the business
      - `dateFormed` string
      - `tin` string, required — Tax ID Number of the business. - In the US this is the 9 digital TIN - In Canada this is the 9 digit business id - In the rest of the world it varys
      - `website` string, required — Main website to the landing page of the business
      - `phoneNumber` string — Business contact phone number, when the KYB vendor collected one
      - `entityType` string — Type of business
      - `business` KybInformationBusiness, required
        - `country` string, required — Main business country
        - `zip` string, required — Main business zip code
        - `state` string, required — Main business state/providence
        - `city` string, required — Main business city
        - `address2` string
        - `address1` string, required — Main business street address
      - `person` KybInformationPerson, required
        - `email` string, required — Email of the main business contact
        - `lastName` string, required — Last name of the main business contact
        - `firstName` string, required — First name of the main business contact
      - `merchantId` string — The merchant the business is interacting with
    - `ubos` UboInfo[], required — Ultimate Beneficiary owners, these are Officers, Directors, Investors and Beneficiaries who own more than 20% of the company.
      - `ssn` string, required
      - `dob` string, required
      - `country` string, required — ISO 3166-1 alpha-2 country codes
      - `zip` string, required
      - `state` string, required
      - `city` string, required
      - `physicalAddress` string, required
      - `surName` string, required
      - `firstName` string, required
  - SellerUsKycBody
    - `email` string, required
    - `onboardingToken` string — Server-signed onboarding token minted by the parent marketplace. The parent is derived from this token — it cannot be supplied directly. Not required when the request is authenticated with the marketplace's API key; the parent is then derived from the key.
    - `sellerId` string, required — MerchantId of the individual seller
    - `individual` boolean, required
    - `info` KycUserInformation, required
      - `email` string, required
      - `firstName` string, required
      - `surName` string, required
      - `physicalAddress` string, required
      - `city` string, required
      - `state` string, required
      - `zip` string, required
      - `country` string, required — ISO 3166-1 alpha-2 country codes
      - `dob` string, required — Date of birth in YYYYMMDD format
      - `ssn` string, required — 4 Digit SSN
  - SellerDocVKybBody
    - `email` string, required
    - `onboardingToken` string — Server-signed onboarding token minted by the parent marketplace. The parent is derived from this token — it cannot be supplied directly. Not required when the request is authenticated with the marketplace's API key; the parent is then derived from the key.
    - `sellerId` string, required — MerchantId of the individual seller
    - `business` boolean, required
    - `country` string, required
  - SellerDocVKycBody
    - `email` string, required
    - `onboardingToken` string — Server-signed onboarding token minted by the parent marketplace. The parent is derived from this token — it cannot be supplied directly. Not required when the request is authenticated with the marketplace's API key; the parent is then derived from the key.
    - `sellerId` string, required — MerchantId of the individual seller
    - `individual` boolean, required
    - `country` string, required
    - `disableAutoApprove` boolean

## Response `200`

Successful response

## Other responses

- `451` — Must Complete Additional Verification

---

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