Skip to main content

Create Partner

Endpoint for creating a Partner.

info

Please be aware that this endpoint requires a Manage Partners API Key.

POST /api/v1/groups/{group_id}/partners

Request Parameters

NameDescriptionTypeRequired
companyCompany Name of the Partner. Maximum 64 characters.stringRequired
first_nameFirst Name of the Partner.string
last_nameLast Name of the Partner.string
emailEmail address of the Partner.stringRequired
line_1First address line of the Partner.stringRequired
line_2Second address line of the Partner.string
cityCity of the Partner.stringRequired
countryCountry of the Partner.stringRequired
subdivisionSubdivision of the Partner.stringRequired
postal_codePostal Code of the Partner.stringRequired

Response

CodeDescription
200Success
400Bad Request / Validation error
500Internal Error

Example Usage

create.js
var headers = new Headers();
headers.append('Authorization', 'API_KEY');

var requestOptions = {
method: 'POST',
headers: headers,
redirect: 'follow',
body: {
// request body data
}
};
const group_id = '';
const url = `https://api.reverepayments.dev/api/v1/groups/${group_id}/partners`;
fetch(url, requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.log('error', error));

Example Request

{
"company": "Knockout Kickboxing",
"first_name": "John",
"last_name": "Doe",
"email": "knockout.kickboxing@domain.com",
"line_1": "2672 Woodland Avenue",
"line_2": "Apt 5B",
"city": "Larose",
"country": "US",
"subdivision": "LA",
"postal_code": "70373"
}

Example Success Response

{
"id": "062ea47f-9a4f-4314-baa3-3053dbcdec3d",
"group_id": "655e5d89-5541-4852-b284-58772dbdfd90",
"company": "Knockout Kickboxing",
"first_name": "John",
"last_name": "Doe",
"email": "knockout.kickboxing@domain.com",
"line_1": "2672 Woodland Avenue",
"line_2": "Apt 5B",
"city": "Larose",
"country": "US",
"subdivision": "LA",
"postal_code": "70373",
"created_at": "2025-11-19T14:26:05.141114361Z",
"updated_at": "2025-11-19T14:26:05.141114361Z"
}