Skip to main content
GET
Submit feedback for a lead using query parameters

Query Parameters

event_id
string
required
read-only

The ID of the delivery event the feedback refers to, shared with the recipient when the lead was delivered. 24 character alpha-numeric BSON identifier

Pattern: ^[0-9a-fA-F]{24}$
Example:

"5fd4371e940df5a34a3888b2"

type
enum<string>
required

The kind of feedback being given.

Available options:
conversion,
return
reason
string

The lifecycle stage the lead reached, or the reason it is being returned. Optional, but usually what the step's acceptance criteria are written against.

Example:

"Sale Closed"

occurred_at
string

When the status changed in your system, as an ISO 8601 timestamp. Defaults to the time LeadConduit received the feedback.

Example:

"2026-05-30T08:00:00Z"

Response

The feedback submission was processed. Check the outcome field to see whether it was accepted.

The result of a feedback submission. Returned as JSON by default, or as XML (wrapped in a <result> root element) when requested via the Accept header.

outcome
enum<string>

Whether the feedback was accepted. Check this field rather than the status code — a rejected submission is still reported with 201.

Available options:
success,
failure,
error
Example:

"success"

reason
string | null

The reason the feedback was not recorded, when the outcome is not success.

price
number

The price paid to the recipient for the lead. Present only when the delivery step priced the lead.

lead
object

Identifying details of the lead the feedback applies to.