---
title: "Create an External Account"
method: POST
path: "/api/b2b/external-accounts"
---

# Create an External Account

`POST /api/b2b/external-accounts`

External accounts, also known as beneficiaries, are records of accounts where funds can be sent (payouts) or from which funds can be initiated (deposits). This can represent an individual's bank account, a business account, or a mobile money account, depending on the type.

## Request body

- object
  - `country` string, required
  - `currency` string, required
  - `type` string, required — deposit or payout
  - `payload` object, required
    - `firstName` string — Required for type momo deposit.
    - `lastName` string — Required for type momo deposit.
    - `phoneNumber` string — Required for type momo deposit.
    - `destination` string — Required for type payout.
    - `payoutMethod` object — Required for type payout
      - `accountName` string, required — e.g Clark Kent
      - `accountNumber` string, required — 254712345678
      - `code` string — Might be required depending on the currency and destination. All bank payouts require the bank code which can be retrieved from the get banks api. For mobile money payouts, some currencies require a mobile operator code which can be retrieved from the mobile money providers api.
      - `businessNumber` string — Only applies for Mpesa paybill payouts

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `id` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/honeycoin/apis/honeycoin-v3-api-official.md) · [All operations](https://skmtc.net/honeycoin/apis/honeycoin-v3-api-official/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycoin/honeycoin-v3-api-official/revisions/f3fef13ed253/schema)