---
title: "Create Seller"
method: POST
path: "/api/b2b/escrows/sellers/"
---

# Create Seller

`POST /api/b2b/escrows/sellers/`

Create a new seller profile for escrow balance tracking

## Request body

- object
  - `name` string, required — The seller's name
  - `email` string, required — User's email.
  - `currency` string, required — The user's default currency
  - `defaultPayoutDetails` object, required — The default seller's payout details.
    - `method` string, required — Allowed values: momo.
    - `country` string, required — Must be in ISO 3166-1 alpha-2 format e.g KE
    - `payoutMethod` object
      - `accountName` string, required — e.g Clark Kent
      - `accountNumber` string, required — 254712345678
      - `code` string — Might be required depending on the currency and destination. All bank payouts require the bank code which can be retrieved from the get banks api. For mobile money payouts, some currencies require a mobile operator code which can be retrieved from the mobile money providers api.
      - `businessNumber` string — Only applies for Mpesa paybill payouts

## Response `200`

200

- object
  - `success` boolean
  - `data` object
    - `id` string
    - `name` string
    - `email` string
    - `currency` string
    - `defaultPayoutDetails` object
      - `method` string
      - `country` string
      - `payoutMethod` object
        - `accountName` string
        - `accountNumber` integer
        - `code` string
    - `aggregatedBalance` object
    - `createdAt` integer
    - `updatedAt` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/honeycoin/apis/honeycoin-v3-api-official.md) · [All operations](https://skmtc.net/honeycoin/apis/honeycoin-v3-api-official/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycoin/honeycoin-v3-api-official/versions/f3fef13ed253/schema)