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

# Update a payee

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

## Request

- Base URL: `https://api.starlingbank.com`
- URL: `https://api.starlingbank.com/api/v2/payees/{payeeUid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/starlingbank/apis/starling-bank-api/docs/api/v2/payees/:payeeUid/put.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/starlingbank/apis/starling-bank-api.md) - [All operations](https://skmtc.dev/starlingbank/apis/starling-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlingbank/apis/starling-bank-api/revisions/7c5075cfbe63?raw)