CampaignCreate

An A/B campaign for an agent. While active and within its time window, it splits matching leads into weighted buckets that override prompts, model config and/or outreach settings, so variants can be compared. (For outbound dispatch programs see outreach-campaigns.)

nameNamerequired

Human-readable campaign name.

product_idProduct Idrequired

ID of the product (workspace) that owns this record. Most endpoints scope access by product.

agent_idAgent Idrequired

ID of the agent (a configured AI assistant / bot persona) this record belongs to.

starts_at object

When the campaign becomes active (UTC); null means no lower bound.

anyOf

• date-time
• null

date-time

expires_at object

When the campaign stops being active (UTC); null means no upper bound.

anyOf

• date-time
• null

date-time

is_activeIs Active

Whether the campaign is enabled. Active campaigns require bucket weights summing to 100.

Default value: true

batch_names object

Comma-separated, normalized batch tokens this campaign targets; empty/null targets leads generically.

anyOf

• string
• null

string

config object

Free-form campaign configuration (JSON).

property name*any

Free-form campaign configuration (JSON).

CampaignCreate

{
  "name": "string",
  "product_id": 0,
  "agent_id": 0,
  "starts_at": "2024-07-29T15:51:28.071Z",
  "expires_at": "2024-07-29T15:51:28.071Z",
  "is_active": true,
  "batch_names": "string",
  "config": {}
}