---
title: "Create external payments"
method: POST
path: "/external-payments"
tags: ["External Payments"]
---

# Create external payments

`POST /external-payments`

Records one or more external payments in a single batch (max 100). Each payment targets a recipient by `payeeEmail` or `recipientId`.

## Request body

- CreateExternalPaymentsRequest
  - `externalPayments` ExternalPaymentInput[], required
    - `payeeEmail` string, email
    - `recipientId` string, uuid
    - `amount` integer, required — Amount in cents.
    - `description` string
    - `date` string, date — Payment date (YYYY-MM-DD). Defaults to today.
    - `paymentMethod` string — How the payment was made, e.g. `paypal`, `wire`.
    - `platform` string — Platform the payment originated from.
    - `idempotencyKey` string — Per-payment idempotency key.
  - `idempotencyKey` string — Batch-level idempotency key.

## Response `201`

The external payments were created.

- object
  - `data` object
    - `batchId` string, uuid
    - `payments` object[]
      - `id` string, uuid
      - `createdAt` string, date-time

## Other responses

- `400` — The request was invalid.
- `401` — Missing or invalid API key.
- `404` — The requested resource was not found.

---

[API](https://skmtc.net/trykarat/apis/karat-payout-api.md) · [All operations](https://skmtc.net/trykarat/apis/karat-payout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trykarat/karat-payout-api/versions/8941916e3707/schema)