Campaigns and publishers
Each tool lists the inputs your assistant can send. You do not type these yourself: ask in plain language and the assistant fills them in.
List campaigns
Section titled “List campaigns”Tool name: teleflows_list_campaigns
Lists campaigns your API key can access.
Use it to find a campaign by name, get its ID for other tools, count campaigns by status (pagination.total), or find campaigns that use a given routing plan, workflow or publisher (filters take IDs from the matching list tools). A campaign record holds only its name, country, status, open-to-publishers flag and dates; for payout tiers, publishers, routing plan or workflow use teleflows_get_campaign.
Inputs
| Input | Details | Description |
|---|---|---|
status |
string; draft, active, paused, archived |
Campaign status. |
publisher_id |
string; 36 characters | The publisher ID (UUID). |
routing_plan_id |
string; 36 characters | The routing plan ID (UUID). |
workflow_id |
string; 36 characters | The workflow ID (UUID). |
unlinked |
boolean; true |
Only true is supported; its meaning is not documented by Teleflows. |
search |
string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
sort |
string; newest_first, oldest_first; default newest_first |
Order by creation time. |
page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
page_size |
integer; 1 to 100; default 20 |
Records per page, 1-100. |
Get campaign
Section titled “Get campaign”Tool name: teleflows_get_campaign
Gets one campaign by ID, optionally with its payout tiers, member publishers, routing plan and workflow (include).
Use it for “show me campaign X and how it pays / who sends traffic / how it routes”. Payout tiers: amounts in cents, rev_share_pct is a string, Teleflows evaluates tiers in priority order; which tier a specific call matched is not available. Publishers: membership records with publisher IDs; names are added by this server. Routing plan and workflow are not stored on the campaign; this server finds them by checking which routing plan and workflow list the campaign, and says so. Tracking numbers: use teleflows_list_tracking_numbers with campaign_id.
Inputs
| Input | Details | Description |
|---|---|---|
campaign_id |
string; required; 36 characters | The campaign ID (UUID). |
include |
array; payout_tiers, publishers, routing_plan, workflow |
Related data to add; each part is fetched only when listed. |
tiers_page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
publishers_page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
List publishers
Section titled “List publishers”Tool name: teleflows_list_publishers
Lists publishers your API key can access (name, sub ID, active flag, timezone).
Use it to find a publisher by name and get its ID for other tools. For one publisher’s campaigns or SIP connection use teleflows_get_publisher. There is no filter for active publishers: check is_active in the results.
Inputs
| Input | Details | Description |
|---|---|---|
search |
string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
sort |
string; newest_first, oldest_first; default newest_first |
Order by creation time. |
page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
page_size |
integer; 1 to 100; default 20 |
Records per page, 1-100. |
Get publisher
Section titled “Get publisher”Tool name: teleflows_get_publisher
Gets one publisher by ID, optionally with the campaigns it belongs to, its SIP connection status and its SIP event history (include).
SIP status is the saved state; reading it does not trigger a connection check, and SIP usernames and passwords are never returned. SIP history is paged, without a time filter; its order is not documented. For campaigns of a publisher, teleflows_list_campaigns with publisher_id gives full campaign records.
Inputs
| Input | Details | Description |
|---|---|---|
publisher_id |
string; required; 36 characters | The publisher ID (UUID). |
include |
array; campaigns, sip_status, sip_activity |
Related data to add; each part is fetched only when listed. |
campaigns_page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
sip_activity_page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
List tracking numbers
Section titled “List tracking numbers”Tool name: teleflows_list_tracking_numbers
Lists tracking numbers your API key can access.
Use it for “which numbers belong to campaign X”, “how many active US numbers do we have” (pagination.total with page_size 1), or to find a number. A tracking number record has no campaign or publisher field, so filtering is the only way to link them; to find the campaign of one number, filter by each campaign or look at a call to that number. Status values: active, pending, releasing, deleted (their meanings are not documented).
Inputs
| Input | Details | Description |
|---|---|---|
campaign_id |
string; 36 characters | The campaign ID (UUID). |
publisher_id |
string; 36 characters | The publisher ID (UUID). |
status |
string; active, pending, releasing, deleted |
Number status. |
country |
string; 2 characters | Two-letter country code, e.g. US. |
created_after |
string; up to 40 characters | Only records created at or after this moment (inclusive): date-time with timezone, e.g. 2026-10-01T00:00:00Z. |
created_before |
string; up to 40 characters | Only records created at or before this moment (inclusive): date-time with timezone, e.g. 2026-10-31T23:59:59Z. |
search |
string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
sort |
string; newest_first, oldest_first; default newest_first |
Order by creation time. |
page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
page_size |
integer; 1 to 100; default 20 |
Records per page, 1-100. |
List buyers
Section titled “List buyers”Tool name: teleflows_list_buyers
Lists the buyers in the Teleflows account that your API key can access, with each buyer’s company name, sub ID, timezone, active flag and hourly, daily, monthly and concurrency caps.
Use it to find a buyer by company name, to get a buyer’s ID for other tools (for example to filter calls by buyer), or to count buyers (pagination.total). Search matches company names; partial names of 3 or more characters work. Results come newest first by default, 20 per page (up to 100); use page to get more. Records are returned exactly as Teleflows sends them. Caps may be null or -1; Teleflows does not document what either means for buyers, or what counts toward a cap, so do not state that they mean unlimited.
Inputs
| Input | Details | Description |
|---|---|---|
search |
string; up to 200 characters | Part of a company name to match. Omit to list all buyers. |
sort |
string; newest_first, oldest_first; default newest_first |
Order by creation time. |
page |
integer; 1 to 100000; default 1 |
Page number, from 1. |
page_size |
integer; 1 to 100; default 20 |
Buyers per page, 1-100. |