# Creates a new payee.

Use this endpoint to create a new payee.  
- Phone number and Tax ID are optional for individual payee type.  
- Phone number and Tax ID are required for business payee type.

Endpoint: POST /v1/payees/Create
Security: Bearer

## Request fields (application/json):

  - `id` (integer,null)

  - `payeeType` (string, required)
    Example: "INDIVIDUAL|BUSINESS|BRAID"

  - `name` (string,null)

  - `firstName` (string,null)

  - `lastName` (string,null)

  - `email` (string,null)

  - `phoneNumber` (string,null)

  - `taxId` (string,null)

  - `idType` (string,null)

  - `dateOfBirth` (string,null)

  - `address` (object, required)

  - `address.addressLine` (string, required)

  - `address.city` (string, required)

  - `address.country` (string, required)

  - `address.postalCode` (string, required)

  - `address.state` (string,null)

  - `payeeAccount` (object, required)

  - `payeeAccount.type` (string, required)

  - `payeeAccount.currency` (string,null)

  - `payeeAccount.accountType` (string,null)
    Example: "CHECKINGS|SAVINGS"

  - `payeeAccount.accountHolderName` (string,null)

  - `payeeAccount.bankName` (string,null)

  - `payeeAccount.routingNumber` (string,null)

  - `payeeAccount.accountNumber` (string,null)

  - `payeeAccount.branchTransitNumber` (string,null)

  - `payeeAccount.iban` (string,null)

  - `payeeAccount.aba` (string,null)

  - `payeeAccount.abaAccountNumber` (string,null)

  - `payeeAccount.bic` (string,null)

  - `payeeAccount.bicAccountNumber` (string,null)

  - `payeeAccount.pixKeyType` (string,null)

  - `payeeAccount.pixKey` (string,null)

## Response 201 fields (text/plain):

  - `id` (integer)
    Example: 174

  - `payeeType` (string,null)
    Example: "INDIVIDUAL|BUSINESS|BRAID"

  - `name` (string,null)

  - `email` (string,null)

  - `phoneNumber` (string,null)

  - `taxId` (string,null)

  - `businessName` (string,null)
    Example: "ABC Private ltd"

  - `businessType` (string,null)

  - `nationality` (string,null)
    Example: "USA"

  - `idType` (string,null)
    Example: "SSN"

  - `currency` (string,null)
    Example: "USD"

  - `address` (object)

  - `address.addressLine` (string,null)

  - `address.state` (string,null)

  - `address.city` (string,null)

  - `address.country` (string,null)

  - `address.postalCode` (string,null)

  - `dateOfBirth` (string,null)

  - `isActive` (boolean)

## Response 400 fields (text/plain):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `errors` (object,null)