---
title: "Add Sub-merchant"
method: POST
path: "/api/master-merchant/{mkey}/add-merchant"
tags: ["MasterMerchant APIs"]
---

# Add Sub-merchant

`POST /api/master-merchant/{mkey}/add-merchant`

## Request

- Base URL: `https://api.portone.cloud`
- URL: `https://api.portone.cloud/api/master-merchant/{mkey}/add-merchant`
- Auth: none declared

Add or Invite the new sub-merchant. The sub merchant will asked to register if Login Flow is enabled for sub-merchant.

## Path parameters

- `mkey` string, required

## Headers

- `X-Portone-Client-Key` string
- `Authorization` string

## Request body

- object
  - `email_address` string, required: The email of sub-merchant.
  - `name` string, required: The name of sub-merchant.
  - `country` string, required: The country code of sub-merchant.
  - `is_login_allowed` boolean, required: The boolean flag indicating whether is login allowed for sub-merchant.
  - `is_invite_merchant` boolean, required: The boolean flag indicating whether to send invitation to the merchant.
  - `use_master_merchant_creds` boolean, required: The boolean flag indicating whether sub-merchant can use master merchant credentials..
  - `send_kyc_link_email` boolean, required: The boolean flag indicating whether to send KYC to the sub-merchant.

## Response `200`

Successful response

- object
  - `content` AddSubMerchantContent: The object containing the add sub merchant API response data.
    - `kyc_link` string: The KYC page URL for the sub-merchant.
  - `message` string: The description of the API request execution result
  - `status_code` string: The status_code for API request execution result
  - `status_reason` string: The status_reason for API request execution result

## Other responses

- `400`: Failure response
- `401`: Failure response

---

[API](https://skmtc.dev/portone/apis/master-merchant-apis.md) - [All operations](https://skmtc.dev/portone/apis/master-merchant-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/portone/apis/master-merchant-apis/revisions/bc3593c8539c?raw)