---
title: "Create Payout Sender"
method: POST
path: "/payout-sender"
tags: ["Payout Sender"]
---

# Create Payout Sender

`POST /payout-sender`

Create a payout sender to be used as the payer for payouts. The payout sender can be an individual or a company, serving as the source of funds for payouts.

**Required fields:** `sender_name`, `type` (must be "individual" or "company"). All other fields are optional.

**Conditional requirements:**
- If `type` is "individual", provide an `individual` object with the required individual details.
- If `type` is "company", provide a `company` object with the required company details.

### Sender Party explained

- As a merchant paying an invoice from a supplier through a bank transfer, the sender party is the merchant.
    
- For a marketplace platform collecting funds from buyers and sending them to a third party, the source of funds is the buyer.
    
- For a remittance company providing a platform for buyers to remit funds cross-border, the sender party is the buyer.
    
- For a company making payroll payments to employees, the sender party is the company.

> Depending on the market, sender party parameters may change. It is advisable to create a sender party for yourself if funds need to be sent to suppliers.

## Request body

- object
  - `sender_name` string, required — Name of the payout sender
  - `type` 'individual' | 'company', required — Type of sender. Must be either 'individual' or 'company'
  - `description` string — Description of the payout sender
  - `metadata` object, nullable — Custom metadata object
  - `email` string, email — Email address
  - `organization_reference_id` string — A reference you can later use to identify this payout sender, such as an order number. Can only be alphanumeric and must be unique.
  - `address_line1` string — Address line 1
  - `address_line2` string — Address line 2
  - `address_city` string — City
  - `address_state` string — State or province
  - `address_country` string — Country code (ISO 3166-1 alpha-2)
  - `address_zip_code` string — ZIP or postal code
  - `phone_number` string — Phone number
  - `phone_country_code` string — Phone country code (e.g., +1, +61)
  - `phone_number_e164` string — Phone number in E.164 format
  - `individual` object, nullable — **Conditionally required:** If type is 'individual', then this field is mandatory
    - `first_name` string — First name
    - `last_name` string — Last name
    - `dob` string, date — Date of birth (Format: YYYY-MM-DD)
    - `nationality` string — Nationality (ISO 3166-1 alpha-2 country code)
    - `country_of_residence` string — Country of residence (ISO 3166-1 alpha-2 country code)
    - `identification_type` string — Type of identity document: PASSPORT, NATIONAL_ID, DRIVERS_LICENCE, WORK_PERMIT, OTHERS
    - `identification_custom_type` string — Custom identification type (required if identification_type is OTHERS)
    - `identification_value` string — Identification document number
  - `company` object, nullable — **Conditionally required:** If type is 'company', then this field is mandatory
    - `name` string — Company name
    - `registration_number` string — Company registration number
    - `incorporation_country` string — Country of incorporation (ISO 3166-1 alpha-2 country code)

## Response `201`

Created

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) · [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finmo/finmo-api/revisions/1a3073c93930/schema)