---
title: "Update a payee"
method: PUT
path: "/api/v2/payees/{payeeUid}"
tags: ["Payees"]
---

# Update a payee

`PUT /api/v2/payees/{payeeUid}`

## Path parameters

- `payeeUid` string, uuid, required

## Request body

- PayeeCreationRequest — Request to create a payee
  - `payeeName` string, required — Name
  - `phoneNumber` string — Phone number
  - `payeeType` 'BUSINESS' | 'INDIVIDUAL', required
  - `firstName` string — First name
  - `middleName` string — Middle name
  - `lastName` string — Last name
  - `businessName` string — Business name
  - `dateOfBirth` string, date — Date of birth for this payee
  - `accounts` PayeeAccountCreationRequest[] — List of accounts for this payee
    - `description` string, required — Account description
    - `defaultAccount` boolean, required — Is this the default account for the owning payee
    - `countryCode` string, required — The country code for the account (ISO 3166-1 alpha-2)
    - `accountIdentifier` string, required — The account identifier
    - `bankIdentifier` string, required — The bank identifier
    - `bankIdentifierType` 'SORT_CODE' | 'SWIFT' | 'IBAN' | 'ABA' | 'ABA_WIRE' | 'ABA_ACH' | 'BSB', required — The bank identifier type
    - `secondaryIdentifier` string — Secondary reference data (SRD), if applicable

## Response `200`

Successful operation

- ConsentInformation — Denotes whether a request has been paused in order for the user to approve it.

## Other responses

- `4xx` — Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx` — Server error. See [API status codes](#api-status-codes-1) for more details.

---

[API](https://skmtc.net/starlingbank/apis/starling-bank-api.md) · [All operations](https://skmtc.net/starlingbank/apis/starling-bank-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlingbank/starling-bank-api/revisions/fa1a72b9ecec/schema)