---
title: "Create a Cross-border Sender"
method: POST
path: "/api/b2b/cross-border/requests/senders"
tags: ["Cross-border Requests"]
---

# Create a Cross-border Sender

`POST /api/b2b/cross-border/requests/senders`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/cross-border/requests/senders`
- Auth: API key in header `Authorization`

Create an individual or business sender. Save data.id as senderId. Email must be unique among active senders in your account. Individual senders require idNumber; business senders require registrationNumber and omit idNumber. idType accepts passport, national-id, or business-registration-number. Individual fields and business fields are mutually exclusive. Sandbox: use the same suffix under /api/sandbox/b2b/cross-border/requests with a sandbox bearer token.

## Request body

- union
  - object
    - `phoneNumber` string, required: International phone number including + and country calling code.
    - `email` string, email, required: Unique among active senders in your account; normalized to lowercase.
    - `idType` 'passport' | 'national-id' | 'business-registration-number', required
    - `idCountry` string, required: Two-letter country code, uppercase.
    - `idNumber` string, required: Personal identity document number. Required for individual senders; omit registrationNumber.
    - `nationality` string: Two-letter country code, uppercase.
    - `address` CrossBorderAddress, required
      - `country` string, required: Two-letter country code, uppercase.
      - `city` string, required: City; normalized to uppercase.
      - `street1` string, required
      - `street2` string
      - `postalCode` string, required
    - `type` 'individual', required
    - `firstName` string, required: Letters, spaces, apostrophes and hyphens.
    - `lastName` string, required: Letters, spaces, apostrophes and hyphens.
    - `birthday` string, required: Date of birth in YYYY-MM-DD format.
  - object
    - `phoneNumber` string, required: International phone number including + and country calling code.
    - `email` string, email, required: Unique among active senders in your account; normalized to lowercase.
    - `idType` 'passport' | 'national-id' | 'business-registration-number', required
    - `idCountry` string, required: Two-letter country code, uppercase.
    - `nationality` string: Two-letter country code, uppercase.
    - `address` CrossBorderAddress, required
      - `country` string, required: Two-letter country code, uppercase.
      - `city` string, required: City; normalized to uppercase.
      - `street1` string, required
      - `street2` string
      - `postalCode` string, required
    - `type` 'business', required
    - `companyName` string, required: Registered business name.
    - `registrationNumber` string, required: Business registration number. Required for business senders; omit idNumber.

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` CrossBorderSender, required
    - `phoneNumber` string: International phone number including + and country calling code.
    - `email` string, email, required: Unique among active senders in your account; normalized to lowercase.
    - `idType` 'passport' | 'national-id' | 'business-registration-number'
    - `idCountry` string: Two-letter country code, uppercase.
    - `idNumber` string: Personal identity document number for an individual sender.
    - `nationality` string, nullable
    - `address` object
      - `country` string, required: Two-letter country code, uppercase.
      - `city` string, required: City; normalized to uppercase.
      - `street1` string, required
      - `street2` string, nullable
      - `postalCode` string, required
    - `type` 'individual' | 'business', required
    - `firstName` string: Letters, spaces, apostrophes and hyphens.
    - `lastName` string: Letters, spaces, apostrophes and hyphens.
    - `birthday` string: Date of birth in YYYY-MM-DD format.
    - `companyName` string: Registered business name.
    - `id` string, required: Save this ID as senderId when creating requests.
    - `createdAt` integer: Unix timestamp in milliseconds.
    - `updatedAt` integer: Unix timestamp in milliseconds.
    - `registrationNumber` string: Business registration number for a business sender.

## Other responses

- `202`: An identical request is still being processed. Wait and reconcile before retrying; no resource ID is included.
- `400`: Invalid request, bearer token, or current request state.
- `409`: SENDER_EMAIL_IN_USE: an active sender already uses this email.

## Changes

- **2026-11-03** `fcb58b0ef441`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/cross-border/requests/senders/post.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)