Skip to main content
POST
/
vendor
/
sellers
curl -X POST 'http://localhost:9000/vendor/sellers' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Acme Store",
    "email": "store@acme.com",
    "currency_code": "usd",
    "member_email": "owner@acme.com",
    "first_name": "Jane",
    "last_name": "Doe"
  }'

{
  "seller": {
    "id": "sel_01HXYZ",
    "name": "Acme Store",
    "handle": "acme-store",
    "email": "store@acme.com",
    "status": "pending_approval",
    "currency_code": "usd"
  }
}
Creates a seller account, optionally with an initial address, professional details, and payment details.
This is a public route — no Authorization or x-seller-id header is required. When called without an authenticated member, member_email is required so the owner member can be created.

​
Body parameters

​
name
string
required
The seller’s display name.
​
email
string
required
The seller’s contact email.
​
currency_code
string
required
The seller’s default currency code (e.g. usd).
​
handle
string
Unique handle for the seller’s storefront URL.
​
phone
string
The seller’s contact phone number.
​
member_email
string
Email for the owner member — required when there is no authenticated member.
​
first_name
string
First name of the owner member.
​
last_name
string
Last name of the owner member.
​
description
string
Description of the seller’s store.
​
address
object
The seller’s address.
​
professional_details
object
The seller’s business registration details.
​
payment_details
object
The seller’s bank account details.
​
metadata
object
Custom key-value pairs.
​
additional_data
object
Custom data passed to workflow hooks.

​
Response

​
seller
object
curl -X POST 'http://localhost:9000/vendor/sellers' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Acme Store",
    "email": "store@acme.com",
    "currency_code": "usd",
    "member_email": "owner@acme.com",
    "first_name": "Jane",
    "last_name": "Doe"
  }'

{
  "seller": {
    "id": "sel_01HXYZ",
    "name": "Acme Store",
    "handle": "acme-store",
    "email": "store@acme.com",
    "status": "pending_approval",
    "currency_code": "usd"
  }
}