Skip to content

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.

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.

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.

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.

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.

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.

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.