---
title: "Add new funding instrument"
method: POST
path: "/payout/account/topup/instruments"
tags: ["Account"]
---

# Add new funding instrument

`POST /payout/account/topup/instruments`

This **POST** endpoint is used to add a funding account instrument. <br> You can use this endpoint to provide the funding instrument details and add them to your account. <br> The request body requires the `funding_details` of the instrument, such as account and routing number or debit card details and the `country_code` of the country code where this funding instrument resides. <br> The response will include a JSON objects containing funding instrument `token`.

## Request body

- object
  - `funding_details` object, required — Instrument details
    - `account_number` string — Bank account number. Required for ACH
    - `routing_number` string — Bank routing number. Required for ACH
    - `bank_account_type` 'Checking' | 'Savings' — Bank account type for ACH
    - `debit_card_number` string — Debit card number. Required for AFT
    - `debit_card_expiration` string — Debit card expiration date. Format: `MM/YY`. Required for AFT
    - `debit_card_billing_zip` string — Debit card billing zip code
  - `country_code` string, required — 3 letter country code of institution where instrument exists

## Response `200`

successful operation

- object
  - `token` string, required — Token of newly created funding instrument

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

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