Marketing · segment_audience
Segment audience
Create or update a marketing segment.
- Price
- included
- Requirements
- Mailchimp or Brevo
- set it up in Settings → Integrations
- Human approval
- Yes, by default
- outside-facing write: a human validates
Input
| Field | Type | Description |
|---|---|---|
| name * | string | Name of the audience segment |
| description | string | Description of the segment |
| source * | mailchimp | brevo | hubspot | custom | Data source / platform for this audience |
| segmentRules * | object | Rules defining segment criteria (Mailchimp: segment options {match, conditions[]}; otherwise free-form criteria: industry, lifecycle, engagement, location…) |
| size | number | Known number of contacts in the segment (optional) |
| providerListId | string | Existing provider list id to use (Mailchimp audience/list id, Brevo list id) when it differs from the integration default |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"segment_audience","input":{"name":"…","description":"…","source":"mailchimp","segmentRules":"…"}}'$
run({ "tool": "segment_audience", "input": {"name":"…","description":"…","source":"mailchimp","segmentRules":"…"} })