---
title: "Create a payout account"
method: POST
path: "/v4/payout-accounts"
tags: ["Payout Accounts"]
---

# Create a payout account

`POST /v4/payout-accounts`

Create a payout account. This is used to customize the payout for a merchant's orders

## Request body

- CreatePayoutAccountV4RequestDto
  - `name` string, required — A nickname for this bank account
  - `businessName` string — The business name associated with the bank account
  - `email` string — The email address associated with the bank account for notifications
  - `customerId` string — The customer ID associated with the bank account. Only to be used if the payout account should be associated with a customer.
  - `routingNumber` string, required — Bank routing number
  - `address` AddressSharedDto, required
    - `line1` string, required — The first line of the address
    - `line2` string
    - `city` string, required
    - `country` string, required — ISO31661 Alpha2 code for the country
    - `state` string, required — 2-letter US state abbreviation
    - `postalCode` string, required — 5-digit US postal code
  - `accountNumber` string, required — Bank account number
  - `taxId` string, required — Federal Tax ID
  - `isDefaultAccount` boolean — Whether the account is the default used for payouts. Defaults to false
  - `accountType` 'checking' | 'savings', required — Account Type
  - `externalId` string — External ID for your reference

## Response `200`

The created payout account.

- PayoutAccountEntityV4ResponseDto
  - `id` string, required — Payout account ID
  - `name` string, required — Name
  - `externalId` string — External ID
  - `isDefaultAccount` boolean, required — Whether this is the default account for the merchant
  - `createdAt` string, date-time, required — Timestamp of when account was create
  - `updatedAt` string, date-time, required — Timestamp of when account was last updated

---

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