---
title: "Dodaj leady do kampanii"
method: POST
path: "/campaigns/{id}/leads"
tags: ["Kampanie"]
---

# Dodaj leady do kampanii

`POST /campaigns/{id}/leads`

## Request

- Base URL: `https://outreachpilot.pl/api/v1`
- URL: `https://outreachpilot.pl/api/v1/campaigns/{id}/leads`
- Auth: HTTP bearer

Dodaje leady do istniejącej kampanii (do 1000). Pomija leady już obecne, odrzucone, z bounce'em, wypisane i z nieprawidłowym adresem e-mail (`email_status: invalid`; ich liczba jest w `skipped_invalid`). Leady z adresem ryzykownym (`risky`, catch-all) są dodawane, a ich liczba jest w `risky_added`. Gdy kampania jest aktywna, nowe leady od razu wchodzą do wysyłki.

**Wymagany zakres klucza:** `campaigns:write`.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `lead_ids` string[], required: Leady do dodania (1-1000).

## Response `200`

Sukces.

- object
  - `data` CampaignAddLeadsResult, required
    - `added` integer, required
    - `skipped` integer, required: Pominięte: już w kampanii, odrzucone, wypisane, z nieprawidłowym adresem lub nie Twoje.
    - `skipped_invalid` integer: Z tego pominięte, bo adres e-mail ma status `invalid` (nieprawidłowy). Pole jest tylko wtedy, gdy takie leady były.
    - `risky_added` integer: Dodane leady z adresem `risky` (ryzykowny, catch-all): mogą się odbić. Pole jest tylko wtedy, gdy takie leady dodano.
    - `campaign_status` 'szkic' | 'aktywna' | 'wstrzymana' | 'zakonczona' | 'blad', required
    - `notice` string, nullable, required

## Other responses

- `400`: Nieprawidłowe żądanie. Kody: `invalid_request`.
- `401`: Brak, zły, odwołany lub wygasły klucz (`missing_api_key`, `invalid_api_key`, `api_key_revoked`, `api_key_expired`, `account_inactive`).
- `403`: Plan nie obejmuje API (`plan_upgrade_required`, odpowiedź zawiera informacje o planie; nie dotyczy tras wtyczki z kluczem `extension:*`) albo klucz nie ma wymaganego zakresu (`insufficient_scope`).
- `404`: Nie znaleziono. Kody: `not_found`.
- `422`: Błąd walidacji. Kody: `validation_error`, `invalid_request`.
- `429`: Przekroczono limit żądań (`rate_limit_exceeded`). Zobacz nagłówek `Retry-After`.

---

[API](https://skmtc.dev/outreachpilot/apis/outreachpilot-api.md) · [All operations](https://skmtc.dev/outreachpilot/apis/outreachpilot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreachpilot/apis/outreachpilot-api/revisions/2262dabfb07c?raw)