---
title: "Create funding recipient owner"
method: POST
path: "/funding-recipients/{recipientId}/owners"
tags: ["fundingRecipients"]
---

# Create funding recipient owner

`POST /funding-recipients/{recipientId}/owners`

## Request

- Base URL: `https://api.payroc.com/v1`
- URL: `https://api.payroc.com/v1/funding-recipients/{recipientId}/owners`
- Auth: HTTP bearer

Use this method to add an additional owner to a funding recipient.  

To add an owner to a funding recipient, you need the 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.  

In the request, include the following information about the owner:  

- Name, date of birth, and address.  
- Contact details, including their email address.  
- Relationship to the funding recipient, including whether they are a control prong.  

In the response, our gateway returns the ownerId, which you can use to run follow-on actions.

## Path parameters

- `recipientId` integer, required

## Headers

- `Idempotency-Key` string, uuid, required

## Request body

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

## Response `201`

Successful request. We created the owner and added it to the funding recipient.

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

## 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
- `409`: Conflict
- `500`: An error has occured

## Changes

- **2026-09-17** `9fc1e1d5b4a8`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `Bearer` was added to the API
- **2026-09-12** `9af893904873`: 1 info
  - api operation id `createOwner` removed and replaced with `fundingRecipients_createOwner`

[Operation history](https://skmtc.dev/payroc/apis/schema/changes/funding-recipients/:recipientId/owners/post.md)

---

[API](https://skmtc.dev/payroc/apis/schema.md) - [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) - [OpenAPI document](https://skmtc.dev/payroc/apis/schema/revisions/735467f6d8cd?raw)