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

# Add talent to sourcing

> Link a talent to a sourcing as a candidate.

<Card title="First time? Set up Authentication" icon="key" href="/authentication">
  Learn how to authenticate your API requests with your API key.
</Card>

Creates or updates the candidate row for `(talentId, sourcingId)` in your workspace. Status is forced to **TO\_BE\_CONTACTED**. Existing candidates keep their `userRating`; new candidates use server defaults.

## Path parameters

<ParamField path="sourcingId" type="string" required>
  The sourcing id returned by [Create sourcing](/api-reference/create-sourcing).
</ParamField>

## Request body

<ParamField body="talentId" type="string" required>
  Talent identifier to attach.
</ParamField>

## Response

When `success` is `true`, `data` includes `candidateId`, `talentId`, `sourcingId`, `statusHandle`, `userRating`, and `createdAt`.

## Errors

| Code                   | HTTP |
| ---------------------- | ---- |
| `validation_error`     | 400  |
| `insufficient_credits` | 402  |
| `not_found`            | 404  |
| `internal_error`       | 500  |

```bash theme={null}
curl -X POST https://app.kalent.ai/api/v1/sourcings/SOURCING_ID/candidates \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"talentId":"TALENT_ID"}'
```