---
title: "Create Seller"
method: POST
path: "/sellers"
tags: ["Sellers"]
---

# Create Seller

`POST /sellers`

Creates a new franchise seller mapping.

## Headers

- `public-api-key` string, required
- `private-secret-key` string, required

## Request body

- SellerCreate
  - `account_id` string, uuid, required
  - `merchant_seller_id` string, required
  - `name` string
  - `email` string, email
  - `phone` Phone
    - `code` string — Country dialing code (e.g. +1, +57).
    - `number` string
  - `document` Document
    - `type` string
    - `number` string
  - `address` Address
    - `line_1` string
    - `line_2` string
    - `city` string
    - `state` string
    - `country` string
    - `zip_code` string
  - `country` string — ISO 3166-1 alpha-2 country code.
  - `website` string
  - `industry` string
  - `merchant_category_code` string
  - `payment_methods` PaymentMethodConfig[]
    - `provider_id` string, required
    - `payment_method_type` string, required
    - `merchant_id` string
    - `wallet_details` WalletDetails
      - `payment_processing_key` string
      - `payment_processing_certificate` string
      - `merchant_identity_key` string
      - `merchant_identity_certificate` string
      - `merchant_identity_password` string

## Response `201`

Created

- Seller
  - `seller_id` string, uuid
  - `merchant_seller_id` string
  - `name` string
  - `email` string
  - `phone` Phone
    - `code` string — Country dialing code (e.g. +1, +57).
    - `number` string
  - `document` Document
    - `type` string
    - `number` string
  - `address` Address
    - `line_1` string
    - `line_2` string
    - `city` string
    - `state` string
    - `country` string
    - `zip_code` string
  - `country` string
  - `website` string
  - `industry` string
  - `merchant_category_code` string
  - `payment_methods` PaymentMethodConfig[]
    - `provider_id` string, required
    - `payment_method_type` string, required
    - `merchant_id` string
    - `wallet_details` WalletDetails
      - `payment_processing_key` string
      - `payment_processing_certificate` string
      - `merchant_identity_key` string
      - `merchant_identity_certificate` string
      - `merchant_identity_password` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Your API credentials are missing or invalid.
- `409` — Conflict

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)