Skip to main content

Register Champions Set

POST 

/v1/referrals/partner/champions

Register a set of champions for a customer. This replaces the full champion set for the given customer with the provided list of LinkedIn URLs.

Request Body

FieldTypeDescriptionRequired
customer_idstringThe ID of the customer whose champion set is being registered.✅ Yes
champion_linkedin_urlsstring[]List of LinkedIn profile URLs of the champions to register.✅ Yes

Example Request (JSON)

{
"customer_id": "cust_abc123",
"champion_linkedin_urls": [
"https://linkedin.com/in/johndoe",
"https://linkedin.com/in/janesmith"
]
}


Response

The response returns the number of champions successfully registered and any validation errors.

Example Success Response

{
"champions_registered": 2,
"errors": []
}


Error Handling

The API returns appropriate error messages with status codes if something goes wrong.

Error CodeMessageDescription
400Invalid RequestVerify your request is properly formatted
401UnauthorizedVerify you are using a valid API key
500Internal Server ErrorAn unexpected error occurred.

Example Error Response

{
"error": {
"code": 400,
"message":"customer_id is required"
}
}

Request

Responses

Successful response