---
title: "Submit a campaign (1 credit per validated lead, every campaign type; supports idempotency_key)"
method: POST
path: "/v1/campaigns"
---

# Submit a campaign (1 credit per validated lead, every campaign type; supports idempotency_key)

`POST /v1/campaigns`

## Request

- Base URL: `https://api.noseforleads.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.noseforleads.com/v1/campaigns`
- Auth: none declared

## Request body

- SubmitCampaignBody
  - `vertical` string, nullable
  - `geo` string, nullable
  - `query` object, required
  - `idempotency_key` string, nullable

## Response `200`

Idempotent replay: an identical idempotency_key was already submitted — returns the original job_id.

## Other responses

- `202`: Successful Response
- `422`: Validation Error

---

[API](https://skmtc.dev/noseforleads/apis/nose-for-leads-api.md) · [All operations](https://skmtc.dev/noseforleads/apis/nose-for-leads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noseforleads/apis/nose-for-leads-api/revisions/e17825d1f5af?raw)