Skip to main content
POST
/
api
/
v2
/
leads
/
{leadId}
/
feedback
Submit feedback on a lead
curl --request POST \
  --url https://api.example.com/api/v2/leads/{leadId}/feedback
Submits good / bad feedback for a lead. Feedback is per-(lead, segment) - the same lead can be evaluated against multiple segments via different streams, so the body specifies which segment’s classification you’re voting on.

​
Body

FieldTypeDescription
segmentIdnumber (required)The segment id this feedback applies to
feedbackenum (required)"good" or "bad"
badReasonenum"bot", "wrong_gender", "wrong_job", "wrong_skill", "wrong_personality", "zapier", "other". Default "zapier".
badReasonFreeformstringOptional free-text reason, max 500 chars

​
Example

curl -X POST https://www.catchthegoodones.com/api/v2/leads/1234/feedback \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "segmentId": 12, "feedback": "good" }'

​
Response

{ "ok": true }

​
Errors

CodeHTTPWhen
Lead not found404Lead not owned by user
Saved search not found404Segment not owned by user

​
Auth

Bearer API key.