Generate campaign matches
generate_campaign_matchesGenerate creator matches from the campaign goal. Runs one creator search (same daily grant and prepaid credits as search_creators) and saves matches; idempotent on (campaign, profileId). Optional filters narrow the search. Holds the call open until the result, up to 800 seconds. While a send request is open, once the campaign is sent, or while it is archived, it returns a tool error naming the reason before any search runs. Needs a credential.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campaignId": "<campaignId>"
},
"name": "generate_campaign_matches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Follower tier: nano 1,000 to 9,999, micro 10,000 to 49,999, mid 50,000 to 249,999, macro 250,000 to 999,999, mega 1,000,000 or more, nano+ 1,000 or more, micro+ 10,000 or more, mid+ 50,000 or more, macro+ 250,000 or more, micro- 1,000 to 49,999, mid- 1,000 to 249,999, macro- 1,000 to 999,999. A plus tier means that follower count and above, and a minus tier means that tier and every smaller one. | |
| country | No | One or more ISO 3166-1 alpha-2 country codes in either letter case, comma separated, such as us or us,ca | |
| platform | No | Instagram (ig) or TikTok (tt), in either letter case | |
| campaignId | Yes | Campaign id from list_campaigns |