---
title: "Create Merchant"
method: POST
path: "/merchant/"
tags: ["Authentication"]
---

# Create Merchant

`POST /merchant/`

Onboard a new merchant onto the Chowdeck platform. Provide business details including contact information, delivery settings, bank account for payouts, operating hours, and webhook URLs for receiving order notifications.

## Request body

- object
  - `reference` string, required — A unique identifier for the merchant
  - `email` string, required — The email address of the merchant.
  - `first_name` string, required — The first name of the merchant's representative.
  - `last_name` string, required
  - `description` string, required — A brief description of the merchant's services.
  - `support_contact` string, required — A contact number for support inquiries.
  - `support_email` string — An email address for support inquiries.
  - `minimum_delivery_time` integer — The minimum time (in minutes) required for delivery.
  - `cover_images` object[] — An array containing image paths for the merchant's cover image
    - `path` string — The url to the cover image.
  - `tags` string[] — Tags associated with the merchant.
  - `bank_code` string — The bank code for the merchant's account.
  - `account_number` string — The account number of the merchant.
  - `account_name` string — The name associated with the bank account.
  - `address` object, required — An object containing the geographical coordinates of the merchant's location.
    - `latitude` string, required — The latitude of the merchant's address.
    - `longitude` string, required — The longitude of the merchant's address.
  - `available_hours` object — An object specifying the merchant's operating hours.
    - `monday` object
      - `opening` integer — The opening time in 24-hour format.
      - `closing` integer — The closing time in 24-hour format.
    - `default` object
      - `opening` integer — The opening time in 24-hour format.
      - `closing` integer — The closing time in 24-hour format.
  - `test_webhook_url` string — A URL for testing webhook notifications.
  - `live_webhook_url` string — A URL for live webhook notifications.

## Response `200`

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/chowdeck/apis/chowdeck-api.md) · [All operations](https://skmtc.dev/chowdeck/apis/chowdeck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chowdeck/chowdeck-api/revisions/5830cc8467d8/schema)