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

# Create a payee account

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

## Path parameters

- `payeeUid` string, uuid, required

## Request body

- PayeeAccountCreationRequest — Request to create a payee account
  - `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

- PayeeAccountCreationResponse — Response after attempting to create a payee account
  - `payeeAccountUid` string — The newly created payee unique identifier, only present on successful payee account creation
  - `success` boolean — True if the method completed successfully
  - `errors` ErrorDetail[]
    - `message` string — The error message

## 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)