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
| Field | Type | Description | Required |
|---|---|---|---|
customer_id | string | The ID of the customer whose champion set is being registered. | ✅ Yes |
champion_linkedin_urls | string[] | 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 Code | Message | Description |
|---|---|---|
| 400 | Invalid Request | Verify your request is properly formatted |
| 401 | Unauthorized | Verify you are using a valid API key |
| 500 | Internal Server Error | An unexpected error occurred. |
Example Error Response
{
"error": {
"code": 400,
"message":"customer_id is required"
}
}
Request
Responses
- 200
Successful response