---
title: "Create a merchant account"
method: POST
path: "/merchants"
tags: ["Account - merchant level"]
---

# Create a merchant account

`POST /merchants`

Creates a merchant account for the company account specified in the request.

Use this endpoint if your integration requires it, such as Adyen for Platforms Manage. Your Adyen contact will set up your access.

To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Accounts read and write

## Request body

- CreateMerchantRequest
  - `businessLineId` string — The unique identifier of the [business line](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businessLines). Required for an Adyen for Platforms Manage integration.
  - `companyId` string, required — The unique identifier of the company account.
  - `description` string — Your description for the merchant account, maximum 300 characters.
  - `legalEntityId` string — The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/legalEntities). Required for an Adyen for Platforms Manage integration.
  - `pricingPlan` string — Sets the pricing plan for the merchant account. Required for an Adyen for Platforms Manage integration. Your Adyen contact will provide the values that you can use.
  - `reference` string — Your reference for the merchant account. To make this reference the unique identifier of the merchant account, your Adyen contact can set up a template on your company account. The template can have 6 to 255 characters with upper- and lower-case letters, underscores, and numbers. When your company account has a template, then the `reference` is required and must be unique within the company account.
  - `salesChannels` string[] — List of sales channels that the merchant will process payments with

## Response `200`

OK - the request has succeeded.

- CreateMerchantResponse
  - `businessLineId` string — The unique identifier of the [business line](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businessLines).
  - `companyId` string — The unique identifier of the company account.
  - `description` string — Your description for the merchant account, maximum 300 characters.
  - `id` string — The unique identifier of the merchant account. If Adyen set up a template for the `reference`, then the `id` will have the same value as the `reference` that you sent in the request. Otherwise, the value is generated by Adyen.
  - `legalEntityId` string — The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/legalEntities).
  - `pricingPlan` string — Partner pricing plan for the merchant, applicable for merchants under AfP managed company accounts.
  - `reference` string — Your reference for the merchant account.

## Other responses

- `204` — No Content - the request has been successfully processed, but there is no additional content.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/management-api.md) · [All operations](https://skmtc.net/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/management-api/versions/1089ade06e17/schema)