# Push leads in live

> POST /campaigns/{id}/contacts. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/campaigns/post-campaigns-id-contacts-push-leads-in-live

POST https://server.heyrik.com/api/v1/campaigns/{id}/contacts

## Path parameters

- id (required): Replace {id} in the request URL with the value for this resource.

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- contacts (array, required): [{ phone, name, …any custom fields }].

## Notes

Extra fields become {{variables}} in the agent's prompt for that lead — by meaning, not by exact name ("fullName" fills {{prospect_name}}). Works on a running campaign (dialled on the next tick) and on a completed one (it reopens). Send phone as text: a spreadsheet value like 9.17993E+11 has lost digits and is skipped, never dialled. Response: { added, skipped, rounded, total, reopened }.

## Request example

```sh
curl -X POST https://server.heyrik.com/api/v1/campaigns/cmp_4a19/contacts \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      { "phone": "+919876543210", "name": "Ravi", "order_id": "AC-8842" }
    ]
  }'
```