Campaigns

Choose the right data source for campaign generation.

Every campaign needs recipient data. Use CSV for batch lists, Zapier or Pabbly for no-code automation, Leadr for outreach workflows, or the API for product-owned generation.

Source

Choose a source

Campaign data source options in AI Studio
Campaign setup starts by choosing the source of recipient data, including CSV, Zapier, Lead Finder, and Leadr paths.
CSV
Best for batch generation, quick testing, and one-time lists.
Zapier
Best when a connected app event should trigger BHuman.
Pabbly
Best when a webhook builder sends object-style variables.
Leadr
Best for LinkedIn-style outreach workflows with optional video personalization.
API
Best when your product or backend controls generation and delivery.

CSV

CSV data

CSV headers become campaign mapping options. Rows with all empty values are skipped during parsing, and large files are parsed in a worker path.

  • Use one column per variable.
  • Trim header names and keep them stable.
  • Include URL columns for background mode assets when needed.
  • Use a small test CSV before uploading a full list.

Automation

No-code automation sources

Zapier
Uses generated Zapier credentials from Settings and connects BHuman to supported Zapier apps.
Pabbly
Uses a simple payload where variables are supplied as object keys.

API

API data

API generation uses either ordered rows or endpoint-specific payloads. For campaign generation, the variables array defines the order, and each nested array in names supplies one recipient row.

Background assets follow the same row order

If you use Background mode from the API, keep assets rows in the same order as names rows.

Checks

Mapping checks

  • Every required variable has a mapped source field.
  • Mapped fields exist in the CSV headers or payload.
  • Each row has a value for each mapped variable.
  • Background mode columns exist before generation starts.
  • Callback URLs and CTA URLs use HTTPS.