---
title: "Create funding recipient"
method: POST
path: "/funding-recipients"
tags: ["fundingRecipients"]
---

# Create funding recipient

`POST /funding-recipients`

Use this method to create a funding recipient. 

A funding recipient is a business or organization that can receive funds but can't run transactions, for example, a charity.  

In the request, include the following information:  
-	Legal information, including its tax ID, Doing Business As (DBA) name, and address.  
-	Contact information, including the email address.  
-	Owners' details, including their contact details. 
-	Funding account details.  

Our gateway returns the recipientId of the funding recipient, which you can use to run follow-on actions.

## Headers

- `Authorization` string, required
- `Idempotency-Key` string, uuid, required

## Request body

- CreateFundingRecipient
  - `recipientId` integer
  - `status` 'approved' | 'rejected' | 'pending'
  - `createdDate` string, date-time
  - `lastModifiedDate` string, date-time
  - `recipientType` 'privateCorporation' | 'publicCorporation' | 'nonProfit' | 'government' | 'privateLlc' | 'publicLlc' | 'privatePartnership' | 'publicPartnership' | 'soleProprietor', required — Type or legal structure of the funding recipient.
  - `taxId` string, required — Employer identification number (EIN) or Social Security number (SSN).
  - `charityId` string — Government identifier of the charity.
  - `doingBusinessAs` string, required — Trading name of the business or organization.
  - `address` CreateFundingRecipientAddress, required — Object that contains information about the address.
    - `address1` string, required — Address line 1.
    - `address2` string — Address line 2.
    - `address3` string — Address line 3.
    - `city` string, required — City.
    - `state` string, required — Name of the state or state abbreviation.
    - `country` string, required — Two-digit country code for the country that the business operates in. The format follows the [ISO-3166-1](https://www.iso.org/iso-3166-country-codes.html) standard.
    - `postalCode` string, required — Zip code or postal code.
  - `contactMethods` ContactMethod[], required — Array of polymorphic objects, which contain contact information. **Note:** You must provide an email address. The value of the type parameter determines which variant you should use: - `email` - Email address - `phone` - Phone number - `mobile` - Mobile number - `fax` - Fax number
    - union
      - object — email variant
        - `type` 'email', required — Discriminator value: email
        - `value` string, required — Email address.
      - object — phone variant
        - `type` 'phone', required — Discriminator value: phone
        - `value` string, required — Phone number.
      - object — mobile variant
        - `type` 'mobile', required — Discriminator value: mobile
        - `value` string, required — Mobile number.
      - object — fax variant
        - `type` 'fax', required — Discriminator value: fax
        - `value` string, required — Fax number.
  - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
  - `owners` Owner[], required — Array of owner objects. Each object contains information about an individual who owns or manages the funding recipient.
    - `ownerId` integer — Unique identifier that we assigned to the owner.
    - `firstName` string, required — Owner's first name.
    - `middleName` string — Owner's middle name.
    - `lastName` string, required — Owner's last name.
    - `dateOfBirth` string, date, required — Owner's date of birth. The format of this value is **YYYY-MM-DD**.
    - `address` Address, required — Object that contains information about the address.
      - `address1` string, required — Address line 1.
      - `address2` string — Address line 2.
      - `address3` string — Address line 3.
      - `city` string, required — City.
      - `state` string, required — Name of the state or state abbreviation.
      - `country` string, required — Two-digit country code for the country that the business operates in. The format follows the [ISO-3166-1](https://www.iso.org/iso-3166-country-codes.html) standard.
      - `postalCode` string, required — Zip code or postal code.
    - `identifiers` Identifier[], required — Array of IDs.
      - `type` 'nationalId', required — Type of ID provided to verify identity.
      - `value` string, required — Social Security Number (SSN) or Social Insurance Number (SIN).
    - `contactMethods` ContactMethod[], required — Array of polymorphic objects, which contain contact information. **Note:** If you are adding information about an owner, you must provide at least an email address. If you are adding information about a contact, you must provide at least a contact number. The value of the type parameter determines which variant you should use: - `email` - Email address - `phone` - Phone number - `mobile` - Mobile number - `fax` - Fax number
      - union
        - object — email variant
          - `type` 'email', required — Discriminator value: email
          - `value` string, required — Email address.
        - object — phone variant
          - `type` 'phone', required — Discriminator value: phone
          - `value` string, required — Phone number.
        - object — mobile variant
          - `type` 'mobile', required — Discriminator value: mobile
          - `value` string, required — Mobile number.
        - object — fax variant
          - `type` 'fax', required — Discriminator value: fax
          - `value` string, required — Fax number.
    - `relationship` OwnerRelationship, required — Object that contains information about the owner's relationship to the business.
      - `equityPercentage` number, double — Percentage equity stake that the owner holds in the business.
      - `title` string — Owner's job title.
      - `isControlProng` boolean, required — Indicates if the owner is a control prong. You can identify only one control prong for a business.
      - `isAuthorizedSignatory` boolean — Indicates if the owner is an authorized signatory.
  - `fundingAccounts` FundingAccount[], required — Array of fundingAccount objects that you can use to add funding accounts to the funding recipient.
    - `fundingAccountId` integer — Unique identifier that we assigned to the funding account.
    - `createdDate` string, date-time — Date and time that we received your request to create the funding account in our system.
    - `lastModifiedDate` string, date-time — Date and time that the funding account was last modified.
    - `status` 'approved' | 'rejected' | 'pending' | 'hold' — Status of the funding account. The value is one of the following: - `approved` - We approved the funding account. - `rejected` - We rejected the funding account. - `pending` - We have not yet approved the funding account. - `hold` - Our Risk team have temporarily placed a hold on the funding account.
    - `type` 'checking' | 'savings' | 'generalLedger', required — Type of funding account.
    - `use` 'credit' | 'debit' | 'creditAndDebit', required — Indicates if we send funds or withdraw funds from the account. - `credit` - Send funds to the account. - `debit` - Withdraw funds from the account. - `creditAndDebit` - Send funds and withdraw funds from the account. **Note:** If the funding account is associated with a funding recipient, we accept only a value of `credit`.
    - `nameOnAccount` string, required — Name of the account holder.
    - `paymentMethods` PaymentMethodsItems[], required — Array of PaymentMethodAch objects.
      - `type` 'ach', required — Discriminator value: ach
      - `value` PaymentMethodsItemsDiscriminatorMappingAchValue — Object that contains information about the funding account.
        - `routingNumber` string, required — Routing number of the funding account.
        - `accountNumber` string, required — Account number of the funding account.
    - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
    - `links` Link[] — Array of HATEOAS links.
      - `rel` string, required — Indicates the relationship between the current resource and the target resource.
      - `method` string, required — HTTP method that you need to use with the target resource.
      - `href` string, required — URL of the target resource.

## Response `201`

Successful request. We created the funding recipient.

- FundingRecipient
  - `recipientId` integer — Unique identifier that we assigned to the funding recipient.
  - `status` 'approved' | 'rejected' | 'pending' — Indicates if we have approved the funding recipient.
  - `createdDate` string, date-time — Date the funding recipient was created.
  - `lastModifiedDate` string, date-time — Date the funding recipient was last modified.
  - `recipientType` 'privateCorporation' | 'publicCorporation' | 'nonProfit' | 'government' | 'privateLlc' | 'publicLlc' | 'privatePartnership' | 'publicPartnership' | 'soleProprietor', required — Type or legal structure of the funding recipient.
  - `taxId` string, required — Employer identification number (EIN) or Social Security number (SSN).
  - `charityId` string — Government identifier of the charity.
  - `doingBusinessAs` string, required — Legal name of the business or organization.
  - `address` FundingRecipientAddress, required — Object that contains information about the address.
    - `address1` string, required — Address line 1.
    - `address2` string — Address line 2.
    - `address3` string — Address line 3.
    - `city` string, required — City.
    - `state` string, required — Name of the state or state abbreviation.
    - `country` string, required — Two-digit country code for the country that the business operates in. The format follows the [ISO-3166-1](https://www.iso.org/iso-3166-country-codes.html) standard.
    - `postalCode` string, required — Zip code or postal code.
  - `contactMethods` ContactMethod[], required — Array of polymorphic objects, which contain contact information. The value of the type parameter determines which variant you should use: - `email` - Email address - `phone` - Phone number - `mobile` - Mobile number - `fax` - Fax number
    - union
      - object — email variant
        - `type` 'email', required — Discriminator value: email
        - `value` string, required — Email address.
      - object — phone variant
        - `type` 'phone', required — Discriminator value: phone
        - `value` string, required — Phone number.
      - object — mobile variant
        - `type` 'mobile', required — Discriminator value: mobile
        - `value` string, required — Mobile number.
      - object — fax variant
        - `type` 'fax', required — Discriminator value: fax
        - `value` string, required — Fax number.
  - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
  - `owners` FundingRecipientOwnersItems[], required — Array of owner objects associated with the funding recipient.
    - `ownerId` integer — Unique identifier of the owner.
    - `link` FundingRecipientOwnersItemsLink — Object that contains HATEOAS links for the resource.
      - `rel` string — Indicates the relationship between the current resource and the target resource.
      - `href` string — URL of the target resource.
      - `method` string — HTTP method that you need to use with the target resource.
  - `fundingAccounts` FundingRecipientFundingAccountsItems[], required — Array of fundingAccount objects associated with the funding recipient.
    - `fundingAccountId` integer — Unique identifier of the funding account.
    - `status` 'approved' | 'rejected' | 'pending' | 'hold' — Status of the funding account.
    - `link` FundingRecipientFundingAccountsItemsLink — Object that contains HATEOAS links for the resource.
      - `rel` string — Indicates the relationship between the current resource and the target resource.
      - `href` string — URL of the target resource.
      - `method` string — HTTP method that you need to use with the target resource.

## Other responses

- `400` — Validation errors
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `406` — Not acceptable
- `409` — Conflict
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)