---
title: "Create payee"
method: POST
path: "/v0/legal-persons/{legal-person-id}/bank/payees"
tags: ["Payees"]
---

# Create payee

`POST /v0/legal-persons/{legal-person-id}/bank/payees`

Registers a new payee with a legal person.

You may associate the outcome of a [CoP request](#tag/Confirmation-of-payee) with the payee by supplying a `cop-request-url`.

## Path parameters

- `legal-person-id` string, required

## Request body

- object
  - `account-holder` string, required — The name of the [account holder](/docs/terms/account-holder).
  - `account-number` string, required — A UK account number.
  - `bank-id` string, required — A UK sort code.
  - `cop-request-url` union — Link to a [CoP request](#tag/Confirmation-of-payee).
    - string
    - string

## Response `201`

Created

- object
  - `cop-request-url` union — Link to a [CoP request](#tag/Confirmation-of-payee).
    - string
    - string
  - `payee-url` union, required — Link to the [payee](#tag/Payees).
    - string
    - string
  - `account-number` string, required — A UK account number.
  - `account-holder` string, required — The name of the [account holder](/docs/terms/account-holder).
  - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
    - string
    - string
  - `bank-id` string, required — A UK sort code.
  - `created-at` string, date-time, required — ISO 8601 formatted date-time.
  - `account-url` union — Link to the bank account resource.
    - string
    - string
  - `payee-status` 'deactivated' | 'active', required — The status of the payee; you can only make payments to active payees.
  - `country-code` string, required — ISO 3166-1 alpha-2 two-letter country code.

## Other responses

- `400` — Bad Request
- `401` — Requires an API key to continue
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/7da510b95492/schema)