---
title: "Request a supplier bank account change · Supplier Bank Accounts · COUNT Partner API"
description: "Asks to add, replace or remove the supplier's bank account. The change waits for approval in COUNT. POST /partners/vendor-bank-accounts/{uuid}/changes"
canonical: "https://developers.getcount.com/reference/vendor-bank-accounts/request-vendor-bank-account-change"
source: "https://developers.getcount.com/reference/vendor-bank-accounts/request-vendor-bank-account-change"
---
[Supplier Bank Accounts](https://developers.getcount.com/reference/vendor-bank-accounts) / Request a supplier bank account change

# Request a supplier bank account change

POST NZ· GST `/partners/vendor-bank-accounts/{uuid}/changes`

Asks to add, replace or remove the supplier's bank account. The change waits for approval in COUNT.

To add or replace, send `bankAccount`. To remove, send `changeType: "deactivate"` and no `bankAccount`. The response leaves out `fromBankAccount`, the account being replaced, since reading it needs View Vendor Bank Details; List a vendor's bank account changes has it.

HMAC signature + Bearer access token

[Try this request](https://developers.getcount.com/tools/try-it?method=POST&path=%2Fpartners%2Fvendor-bank-accounts%2F%7Buuid%7D%2Fchanges&body=%7B%0A++%22reason%22%3A+%22New+supplier%22%2C%0A++%22bankAccount%22%3A+%7B%0A++++%22nzBankAccount%22%3A+%2212-3456-7890123-001%22%2C%0A++++%22accountName%22%3A+%22Harbourside+Office+Supplies%22%0A++%7D%0A%7D)

[Vendors API (suppliers)](https://developers.getcount.com/reference/vendors) [Bills API](https://developers.getcount.com/reference/bills) [Keeping in sync guide](https://developers.getcount.com/guides/keeping-in-sync)

#### Path parameters

`uuid` uuid required

The supplier's UUID: its `id` from List vendors. A supplier has at most one active bank account.

#### Request body

`changeType` enum

Send `deactivate` to remove the active account. Omit it to add or replace one.

One of: `deactivate`

`reason` string

Why the change is needed, shown to the approver.

`bankAccount` object

The new account. Required unless `changeType` is `deactivate`, and refused with it.

`nzBankAccount` string required

The account number, `BB-bbbb-AAAAAAA-SSS` (e.g. 12-3456-7890123-00).

`accountName` string

Account holder name.

`defaultParticulars` string

Up to 12 characters.

`defaultCode` string

Up to 12 characters.

`defaultReference` string

Up to 12 characters.

#### Responses

`201` The pending change.

`400` Not a New Zealand workspace, an invalid account number, a field other than those listed, or `bankAccount` missing (or sent with `deactivate`).

`404` Supplier not found, or a removal for a supplier with no active account.

`409` Another change for this supplier is still waiting for approval.

`401` Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

`403` The credential does not have access to this workspace or resource. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-403)

`429` Rate limit exceeded (100 requests per minute per user of each app, or 10,000 per minute per app). Retry after the Retry-After header. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-429)

[Previous GET List a supplier's bank account changes](https://developers.getcount.com/reference/vendor-bank-accounts/list-vendor-bank-account-changes)

POST `https://api.getcount.com/partners/vendor-bank-accounts/{uuid}/changes`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'POST';
const signingPath = '/vendor-bank-accounts/3fa85f64-5717-4562-b3fc-2c963f66afa6/changes';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "reason": "New supplier",
  "bankAccount": {
    "nzBankAccount": "12-3456-7890123-001",
    "accountName": "Harbourside Office Supplies"
  }
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/vendor-bank-accounts/3fa85f64-5717-4562-b3fc-2c963f66afa6/changes`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
  body: bodyString,
});

console.log(await response.json());
```

Response · 201

```json
{
  "status": "success",
  "message": "Vendor bank account change requested; it applies once approved in COUNT",
  "data": {
    "vendorBankAccountChange": {
      "id": "0193a1c2-7b4d-7e10-9a2f-5c6d7e8f9a02",
      "changeType": "create",
      "status": "pending",
      "toBankAccount": {
        "bankCountry": "NZ",
        "railType": "nz_direct_credit",
        "nzBankAccount": "12-3456-7890123-001",
        "nzBankNumber": "12",
        "nzBranchNumber": "3456",
        "nzAccountNumber": "7890123",
        "nzAccountSuffix": "001",
        "accountName": "Harbourside Office Supplies",
        "defaultParticulars": "Acme Ltd",
        "defaultCode": "INV",
        "defaultReference": "ACME-001"
      },
      "reason": "New supplier",
      "requestedBy": {
        "firstName": "Ana",
        "lastName": "Reyes",
        "email": "ana@example.com"
      },
      "approver": {
        "firstName": "Ben",
        "lastName": "Ito",
        "email": "ben@example.com"
      },
      "decidedAt": null,
      "rejectionReason": null,
      "createdAt": "2026-01-15T10:30:00.000Z"
    }
  }
}
```
