Create Seed Audience

zuckerbot_create_seed_audience

Build a Meta custom audience from hashed CAPI user data stored for a business, filtered by CRM lifecycle stage (e.g., 'lead', 'customer'). Use this as the first step to create retargeting or reactivation audiences from your own first-party CRM data. Passing adopt_meta_audience_id recovers a seed audience that was created on Meta but failed to register (from a prior audience_registry_write_failed error): it skips Meta audience creation and user upload and only writes the registry record.

Parameters

Name	Type		Description
`business_id`	string	optional	Optional business ID override
`source_stage`	string	required	CRM lifecycle or source stage to seed from
`name`	string	optional	Optional audience name override
`lookback_days`	number	optional	How many days of CAPI events to include
`min_contacts`	number	optional	Minimum matched contacts required before creation
`adopt_meta_audience_id`	string	optional	Recovery only: the meta_audience_id from a prior audience_registry_write_failed error. Verifies the audience exists on the bound ad account, then registers it without re-creating it or re-uploading users.

Example call

{
  "tool": "zuckerbot_create_seed_audience",
  "arguments": {
    "source_stage": "<source_stage>"
  }
}

You never invoke this directly — describe what you want in plain English inside Claude, Cursor, ChatGPT or any MCP client with ZuckerBot connected, and the agent selects zuckerbot_create_seed_audience and fills the arguments for you.

Related tools — Audiences

Connect ZuckerBot to your AI agent in about two minutes: get started free, browse the full tool reference, or grab the lifetime deal.