---
title: "Campaigns and publishers"
url: "https://docs.teleflows.io/guides/mcp/reference/tools/campaigns-and-publishers.md"
canonical_url: "https://docs.teleflows.io/guides/mcp/reference/tools/campaigns-and-publishers/"
last_updated: 2026-10-01
type: reference
summary: "Reference for the 6 campaigns and publishers tools of the Teleflows MCP server."
---

# 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

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

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

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

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

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

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. |
