---
title: "Create a Recipient"
method: POST
path: "/recipients"
tags: ["Recipients"]
---

# Create a Recipient

`POST /recipients`

## Headers

- `Trace-Id` string
- `End-User-Agent` string
- `End-User-Ip` string
- `End-User-OS` string
- `End-User-Device-Id` string
- `End-User-Device-Manufacturer` string
- `End-User-Device-Model` string

## Request body

- CreateRecipientRequest
  - `businessName` string, required
  - `categoryId` string, uuid, required
  - `businessAddress` RecipientAddress, required
    - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
    - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
    - `city` string, required — City, district, suburb, town, or village.
    - `state` string, required — State, county, province, or region.
    - `postalCode` string, required — ZIP or postal code.
    - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
  - `contact` union, required
    - ContactWithEmail
      - `firstName` string
      - `lastName` string
      - `email` string, required
      - `phone` string
    - ContactWithPhone
      - `firstName` string
      - `lastName` string
      - `email` string
      - `phone` string, required
  - `receivingMethod` union, required
    - ACH
      - `type` 'ACH', required
      - `accountNumber` string, required — Bank ACH account number
      - `routingNumber` string, required — 9 digit bank routing number
      - `beneficiaryName` string, required
    - Check
      - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
      - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
      - `city` string, required — City, district, suburb, town, or village.
      - `state` string, required — State, county, province, or region.
      - `postalCode` string, required — ZIP or postal code.
      - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
      - `normalize` boolean — Normalize address and validate deliverability
    - EFT
      - `type` 'EFT', required
      - `accountNumber` string, required — Bank EFT account number
      - `routingNumber` string, required — 9 digit routing number (Example Canada EFT: 0IIIBBBBB)
      - `beneficiaryName` string, required
    - Wire
      - `type` 'WIRE', required
      - `accountNumber` string, required — Bank wire account number (alphanumeric)
      - `routingNumber` string, required — Bank wire routing number
      - `beneficiaryName` string, required
      - `country` 'US', required — Two-letter country code (ISO 3166-1 alpha-2).
  - `payer` PayerId
    - `id` string, uuid, required
  - `biller` BillerId
    - `id` string, uuid, required
  - `externalId` string — Consumer defined ID that will be attached to this resource
  - `metadata` RecipientMetadata — Additional Recipient information to support operational requirements
    - `accountSettings` AccountSettingsMetadata
      - `emailConfirmation` boolean — Whether or not the associated entity has confirmed its email.
      - `phoneConfirmation` boolean — Whether or not the associated entity has confirmed its phone number.
      - `singleSignOn` boolean — Whether or not the associated entity uses single-sign-on.
      - `singleSignOnType` string — The single-sign-on service the associated entity uses.
      - `twoFactor` boolean — Whether or not the associated entity uses two-factor authentication.
      - `multiFactor` boolean — Whether or not the associated entity uses multi-factor authentication.
    - `beneficialOwners` BeneficialOwner[]
      - `firstName` string
      - `lastName` string

## Response `200`

Recipient created successfully

- Recipient
  - `id` string, uuid
  - `externalId` string — Consumer defined ID that will be attached to this resource
  - `businessName` string
  - `categoryId` string, uuid
  - `businessAddress` RecipientAddress
    - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
    - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
    - `city` string, required — City, district, suburb, town, or village.
    - `state` string, required — State, county, province, or region.
    - `postalCode` string, required — ZIP or postal code.
    - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
  - `contact` object
    - `firstName` string
    - `lastName` string
    - `email` string
    - `phone` string
  - `payer` PayerId
    - `id` string, uuid, required
  - `metadata` RecipientMetadata — Additional Recipient information to support operational requirements
    - `accountSettings` AccountSettingsMetadata
      - `emailConfirmation` boolean — Whether or not the associated entity has confirmed its email.
      - `phoneConfirmation` boolean — Whether or not the associated entity has confirmed its phone number.
      - `singleSignOn` boolean — Whether or not the associated entity uses single-sign-on.
      - `singleSignOnType` string — The single-sign-on service the associated entity uses.
      - `twoFactor` boolean — Whether or not the associated entity uses two-factor authentication.
      - `multiFactor` boolean — Whether or not the associated entity uses multi-factor authentication.
    - `beneficialOwners` BeneficialOwner[]
      - `firstName` string
      - `lastName` string
  - `receivingMethod` union
    - object
      - `type` 'ACH', required
      - `accountNumber` string, required — Bank ACH account number
      - `routingNumber` string, required — 9 digit bank routing number
      - `beneficiaryName` string, required
    - AddressWithNormalization
      - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
      - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
      - `city` string, required — City, district, suburb, town, or village.
      - `state` string, required — State, county, province, or region.
      - `postalCode` string, required — ZIP or postal code.
      - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
      - `normalize` boolean — Normalize address and validate deliverability
    - object
      - `type` 'EFT', required
      - `accountNumber` string, required — Bank EFT account number
      - `routingNumber` string, required — 9 digit routing number (Example Canada EFT: 0IIIBBBBB)
      - `beneficiaryName` string, required
  - `createdAt` string, date-time
  - `status` 'ACTIVE' | 'INACTIVE' | 'UNKNOWN' — The status of an object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/plastiq/apis/plastiq-public-api.md) · [All operations](https://skmtc.dev/plastiq/apis/plastiq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastiq/plastiq-public-api/revisions/cfd776dd9ac5/schema)