The clickthrough endpoint records when a user clicks on an affiliate product offer. Call this endpoint before redirecting the user to the affiliate product page to ensure the click is attributed to your program.
Endpoint
POST /clickthrough/{convo_id}
Path Parameters
The conversation session ID associated with this click event.
Request Body (ProductClick)
Your loyalty program identifier.
The user’s email address.
The conversation session ID. Should match the path parameter.
The offer presentment identifier.
A unique identifier for this click event.
ISO 8601 timestamp of when the click occurred.
Optional product information associated with this click.
Example Request
curl -X POST https://rewardsbot-prod.liquidrewardsapi.com/clickthrough/session-abc123 \
-H "Content-Type: application/json" \
-d '{
"program": "my-loyalty-program",
"email": "user@example.com",
"convo_id": "session-abc123",
"presentation_id": "pres-001",
"click_id": "click-abc123",
"click_datetime": "2024-01-15T10:30:00Z"
}'
Response
Returns HTTP 202 Accepted on success. The body is empty.
Error Responses
| Status | Description |
|---|
422 Unprocessable Entity | Validation error in request body |
Record clicks before redirecting the user. Missing click events may result in unattributed affiliate commissions.
