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

- 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.