---
title: "POST /merchants"
method: POST
path: "/merchants"
tags: ["Merchant Onboarding"]
---

# POST /merchants

`POST /merchants`

Create a merchant.

The API is synchronous and the Scheme TSP is not involved.

## Headers

- `authorization` string, required
- `x-correlation-id` string, required

## Request body

- object
  - `merchantName` string, required — An unique merchant name that is end user friendly.

## Response `201`

Created

- object
  - `merchantId` string, required — Identifier of the merchant provided by Thales at on-boarding.
  - `creationTimestamp` string, required — Token or binding creation timestamp compliant with ISO 8601.

## Other responses

- `400` — Bad request - Not Retryable
- `401` — Unauthorized - Not Retryable
- `429` — Too Many Requests - Retryable
- `500` — Internal Server Error Retry possible
- `503` — Service Unavailable Retry possible

---

[API](https://skmtc.net/thalescloud/apis/d1-oauth-api.md) · [All operations](https://skmtc.net/thalescloud/apis/d1-oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thalescloud/d1-oauth-api/revisions/96089514858c/schema)