---
title: "Create Receiver"
method: POST
path: "/receivers"
tags: ["Receivers"]
---

# Create Receiver

`POST /receivers`

Creates a new Receiver. Allows clients to create a single receiver record, which can later be referenced in payments or disbursements.

## Request body

- union
  - object
    - `email` string, email — Email address of the receiver
    - `phone_number` string — Phone number of the receiver
    - `external_id` string, required — External identifier for the receiver
    - `verifications` object[], required — Verification requirements for the receiver
      - `type` 'date_of_birth' | 'pin' | 'national_id' | 'year_month', required — Type of verification required
      - `value` string, required — Expected verification value
  - object
    - `email` string, email — Email address of the receiver
    - `phone_number` string — Phone number of the receiver
    - `external_id` string, required — External identifier for the receiver
    - `wallets` object[], required — Wallet information for the receiver (max 1 wallet)
      - `address` string, required — Stellar address of the wallet
      - `memo` string — Optional memo for the wallet address

## Response `201`

Receiver created successfully

- Receiver
  - `id` string
  - `phone_number` string
  - `external_id` string
  - `email` string
  - `created_at` string
  - `total_payments` string
  - `successful_payments` string
  - `failed_payments` string
  - `remaining_payments` string
  - `registered_wallets` string
  - `received_amounts` Amount[]
    - `asset_code` string
    - `asset_issuer` string
    - `received_amount` string
  - `wallets` ReceiverWallet[]
    - `id` string
    - `receiver` ReceiverLite
      - `id` string
    - `wallet` WalletLite
      - `id` string
      - `name` string
      - `homepage` string
      - `sep_10_client_domain` string
      - `deep_link_schema` string
      - `enabled` boolean
      - `user_managed` boolean
    - `stellar_address` string
    - `stellar_memo` string
    - `stellar_memo_type` string
    - `created_at` string
    - `updated_at` string
    - `invited_at` string
    - `last_message_sent_at` string — timestamp when the receiver last received an invitation about this wallet
    - `total_payments` string
    - `payments_received` string
    - `failed_payments` string
    - `remaining_payments` string
    - `received_amounts` Amount[]
      - `asset_code` string
      - `asset_issuer` string
      - `received_amount` string
    - `status` 'DRAFT' | 'READY' | 'REGISTERED' | 'FLAGGED'
    - `status_history` ReceiversWalletStatusHistoryEntry[]
      - `status` 'DRAFT' | 'READY' | 'REGISTERED' | 'FLAGGED'
      - `timestamp` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict - receiver already exists

---

[API](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api.md) · [All operations](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stellar/stellar-disbursement-platform-api/versions/39f9dc64156c/schema)