---
title: "Update Payout Sender"
method: PATCH
path: "/payout-sender/{payout_sender_id}"
tags: ["Payout Sender"]
---

# Update Payout Sender

`PATCH /payout-sender/{payout_sender_id}`

Update the details of an existing payout sender. All fields are optional - only include fields you want to update.

## Path parameters

- `payout_sender_id` string, required

## Request body

- object
  - `sender_name` string — Name of the payout sender
  - `type` 'individual' | 'company' — 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
  - `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 — Individual details (required if type is 'individual')
    - `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 — Company details (required if type is 'company')
    - `name` string — Company name
    - `registration_number` string — Company registration number
    - `incorporation_country` string — Country of incorporation (ISO 3166-1 alpha-2 country code)

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[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)