---
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`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/legal-persons/{legal-person-id}/bank/payees`
- Auth: API key in header `Authorization`

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

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `post-legal-persons-legal-person-id-bank-payees` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/legal-persons/:legal-person-id/bank/payees/post.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)