---
title: "Licenses:Create"
method: POST
path: "/licenses"
tags: ["Licenses"]
---

# Licenses:Create

`POST /licenses`

Create a new license and a Pay account under a merchant. You can indicate if the license is authorized to sign or an UBO and you can indicate which rights the account should have. You can also supply a merchant. If a merchant is supplied then you need to have access to that merchant. You need to authenticate with an AT-code as username and a token as password.

## Request body

- object
  - `merchantCode` Code — unresolved $ref
  - `person` object, required
    - `name` string
    - `firstName` FirstName — unresolved $ref
    - `lastName` LastName — unresolved $ref
    - `email` Email — unresolved $ref
    - `language` string
    - `phone` Phone — unresolved $ref
    - `newsletter` boolean
    - `gender` 'M' | 'F'
    - `visitAddress` object
      - `streetName` StreetName, required — unresolved $ref
      - `streetNumber` StreetNumber, required — unresolved $ref
      - `zipCode` ZipCode, required — unresolved $ref
      - `city` City, required — unresolved $ref
      - `countryCode` CountryCode, required — unresolved $ref
    - `notificationGroup` object
      - `technical` boolean
      - `financial` boolean
      - `operations` boolean
    - `platform` object
      - `loginAccount` boolean
      - `loginTpa` boolean
      - `authorisation` 'all' | 'specified'
      - `authorisationGroups` string[]
    - `complianceData` object
      - `pep` Pep — unresolved $ref
      - `pepDescription` PepDescription — unresolved $ref
      - `authorizedToSign` AuthorizedToSign — unresolved $ref
      - `dateOfBirth` DateOfBirth — unresolved $ref
      - `nationality` Nationality — unresolved $ref
      - `ubo` Ubo — unresolved $ref
      - `uboPercentage` UboPercentage — unresolved $ref
      - `relationshipDescription` RelationshipDescription — unresolved $ref
    - `roles` object
      - `primaryContactPerson` boolean
      - `internalAdministrator` boolean

## Response `201`

Created.

- 1 — unresolved $ref

## Other responses

- `400` — Bad request, see response body for more information
- `401` — Unauthorized. Supplied credentials are invalid
- `403` — Forbidden. Supplied credentials have no rights
- `405` — Used HTTP method is not allowed
- `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `415` — Unsupported media. The supplied content type in the content-type parameter in the header is not supported
- `422` — Unprocessable entity, see response body for more information
- `429` — Rate limit reached.
- `500` — An internal error occurred

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc/schema)