---
title: "Preview campaign"
method: POST
path: "/v1/campaigns/preview"
tags: ["Campaigns"]
---

# Preview campaign

`POST /v1/campaigns/preview`

## Request

- Base URL: `https://api.abm.dev`
- URL: `https://api.abm.dev/v1/campaigns/preview`
- Auth: API key in header `X-API-Key`

Preview a campaign before launching — returns estimated credit cost, target count, and validation warnings.

## Request body

- object
  - `name` string, required: Campaign name
  - `source` object, required: Target source (CRM list, upload, or manual)
    - `type` 'hubspot_list' | 'upload' | 'manual'
    - `list_id` string
    - `upload_id` string, uuid
    - `companies` object[]
  - `roles` string[]
  - `options` object
    - `enrich` boolean
    - `auto_approve` boolean
    - `create_in_crm` boolean
    - `max_per_role` integer

## Response `200`

Campaign preview with estimates

- object
  - `preview_id` string, uuid
  - `total_companies` integer
  - `estimated_credits` integer
  - `warnings` string[]

---

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