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

## Request

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

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