---
title: "Update funding recipient"
method: PUT
path: "/funding-recipients/{recipientId}"
tags: ["fundingRecipients"]
---

# Update funding recipient

`PUT /funding-recipients/{recipientId}`

Use this method to update the details of a funding recipient. If a request contains significant changes, we might need to re-approve the funding recipient.  

To update a funding recipient, you need it's recipientId. Our gateway returned the recipientId in the response of the [Create Funding Recipient](https://docs.payroc.com/api/schema/funding/funding-recipients/create) method.  

**Note**: If you don't have the recipientId, use our [List Funding Recipients](https://docs.payroc.com/api/schema/funding/funding-recipients/list) method to search for the funding recipient.  

You can update the following details of a funding recipient:  
- Doing Business As (DBA) name  
- Tax ID and charity ID  
- Address and contact methods

## Path parameters

- `recipientId` integer, required

## Headers

- `Authorization` string, required

## Request body

- 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.

## Response `204`

Successful request. We updated the funding recipient.

- object

## Other responses

- `400` — Validation errors
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `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)