> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchthegoodones.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit feedback on a lead

> Mark a lead as good or bad. Feedback is per-(lead, segment) pair.

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

| Field               | Type              | Description                                                                                                                  |
| ------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `segmentId`         | number (required) | The segment id this feedback applies to                                                                                      |
| `feedback`          | enum (required)   | `"good"` or `"bad"`                                                                                                          |
| `badReason`         | enum              | `"bot"`, `"wrong_gender"`, `"wrong_job"`, `"wrong_skill"`, `"wrong_personality"`, `"zapier"`, `"other"`. Default `"zapier"`. |
| `badReasonFreeform` | string            | Optional free-text reason, max 500 chars                                                                                     |

## Example

```bash theme={null}
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

```json theme={null}
{ "ok": true }
```

## Errors

| Code                     | HTTP | When                      |
| ------------------------ | ---- | ------------------------- |
| `Lead not found`         | 404  | Lead not owned by user    |
| `Saved search not found` | 404  | Segment not owned by user |

## Auth

Bearer API key.