---
title: "Nominate a bank account user"
method: POST
path: "/v3/funding-accounts/banks/users/nominate"
tags: ["funding-accounts"]
---

# Nominate a bank account user

`POST /v3/funding-accounts/banks/users/nominate`

Nominate a bank account user.

When you nominate a user, BILL performs a set of operations.
* The bank account user `verificationStatus` is set as `NOMINATED`.
* BILL sends the user an email asking them to sign in to the BILL web app and complete identity verification. See [Verify your identity](https://developer.bill.com/docs/sandbox-bank-account-setup#verify-your-identity) in the Guides section for test verification information you can enter in the sandbox environment.

After user identity verification is successful, the bank account user `verificationStatus` is set as `VERIFIED` and the user can pay with the specified bank account.

**Note**: The bank account `status` must be set as `VERIFIED` before you can nominate bank account users.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Request body

- NominateBankAccountUserRequestDto — Nominate a bank account user
  - `userId` string, required — BILL-generated ID of the user. The value begins with `006`.
  - `bankAccountId` string, required — BILL-generated ID of the bank account. The value begins with `bac`. **Note**: The bank account `status` must be set as `VERIFIED`.

## Response `200`

Nominate a bank account user response

- StatusDto — The type Delete response dto.
  - `status` 'SUCCESS' | 'FAILURE' — Request status

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)