canonical: https://jentic.com/apis/campaigner.com/campaigner

# Campaigner API

The Campaigner API sends email, SMS, and MMS marketing campaigns to your contact lists and tracks every send and clicked link. It manages contacts, custom fields, segmented lists, and signup forms, and can import or upsert contact data in bulk. Automated marketing workflows, category tagging, and sFTP contact exports round out the account-level campaign surface.

## For AI agents

Send email, SMS, and MMS campaigns, manage segmented contact lists and custom fields, and read per-campaign sends and tracked links through the Campaigner API.

## Scope

Does not handle payment processing, CRM deal tracking, or push notifications. Use for email, SMS, and MMS marketing campaigns only.

## Capabilities

- Send individual SMS and MMS messages to a recipient phone number
- Create, schedule, and cancel email campaigns for a contact list
- Build segmented contact lists with custom fields and signup forms
- Import, update, and upsert contact records in bulk
- Launch SMS campaigns and read their per-recipient sends and tracked links
- Export account contacts over sFTP for downstream processing
- List the automated marketing workflows configured on an account

## Use cases

### AI Agent Campaign Automation

An AI agent connected through Jentic can run a full email or SMS campaign on request: it creates the campaign, sets the recipient list, schedules the send, and reports back the delivery and tracked-link results. Campaigner handles list segmentation, send scheduling, and link tracking so the agent coordinates the sequence instead of wiring each step by hand.

Example prompt: Create an email campaign, set its recipient list, schedule it to send in one hour, and confirm the campaign is queued

### Transactional SMS and MMS Notifications

Send order confirmations, reminders, and alerts as individual SMS or MMS messages. Campaigner delivers each message to a single recipient and records the send for later reporting, which suits one-off notifications triggered by application events.

Example prompt: Send a single SMS reminder to a customer phone number and verify the send was accepted

### Contact List Management

Keep marketing audiences current by importing new contacts, upserting changed records, and organizing them into segmented lists with custom fields. Campaigner supports bulk contact import and signup-form capture so audience hygiene stays current without manual edits.

Example prompt: Import a batch of contacts with email addresses and custom field values into a named list

### Campaign Performance Tracking

Pull the sends and tracked links for a specific email or SMS campaign to measure reach and engagement. Campaigner exposes per-campaign send records and clicked-link data that feed reporting dashboards.

Example prompt: Retrieve the tracked links and send records for a given SMS campaign and summarize the click counts

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/sms/v1/send/single` | Send a single SMS |
| POST | `/mms/v1/send/single` | Send a single MMS |
| POST | `/email/v1/campaign` | Create an email campaign |
| POST | `/sms/v1/campaign` | Create an SMS campaign |
| POST | `/contacts/v1` | Create a contact |
| GET | `/contacts/v1` | List contacts for an account |
| POST | `/lists/v1` | Create a contact list |
| GET | `/workflows/v1` | List automated workflows |

## Key resources

- **Campaigns** — Email, SMS, and MMS campaign creation, scheduling, recipients, and send tracking
- **Contacts** — Contact creation, bulk import, upsert, retrieval, and deletion
- **Lists** — Segmented contact lists and signup forms
- **Fields** — Custom field definitions and field options
- **Workflows** — Listings of automated marketing workflows

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 55 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 59 / 100
  - Developer Experience & Jentic Compatibility: 75 / 100
  - AI-Readiness & Agent Experience: 33 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 71 / 100
- **View full report:** https://jentic.com/apis/campaigner.com/campaigner/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Campaigner by hand means setting up its IntegrationKey header auth and tracking the right versioned paths for SMS, email, contacts, and exports yourself. Through Jentic you install once, import Campaigner from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which Campaigner operations the agent may call, such as sending an SMS or creating an email campaign, so higher-risk operations like deleting contacts or lists are not included unless you add them.
- **Credential handling:** Your Campaigner IntegrationKey is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'send an SMS' or 'create an email campaign', and Jentic returns the matching Campaigner operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Mailchimp Marketing API** — Mailchimp covers email marketing campaigns and audiences with a large template and automation ecosystem.
- **Brevo API** — Brevo offers transactional and marketing email alongside SMS from one account.
- **Plivo API** — Plivo handles high-volume programmable SMS and voice messaging.

## FAQ

### What authentication does the Campaigner API use?

The Campaigner API authenticates with an API key sent in the `IntegrationKey` request header, per its OpenAPI spec. You generate the key from your Campaigner account, and through Jentic it is stored encrypted by your own Jentic One instance and injected when the agent makes a call, so it never appears in the agent's prompt or logs.

### Can I send both SMS and email with the Campaigner API?

Yes. The API exposes separate operations for sending single SMS and MMS messages and for creating, scheduling, and sending email campaigns to a contact list. You can also launch SMS campaigns and read their per-recipient sends and tracked links for reporting.

### Can I manage contact lists with the Campaigner API?

Yes. You can create lists, add and segment contacts, define custom fields, and import or upsert contact records in bulk. Signup-form capture and sFTP contact exports are also available for keeping audiences current.

### Is there a Campaigner MCP server?

You do not need an MCP server to give your agent the Campaigner API. Jentic connects it directly from the API Directory: import Campaigner, store your IntegrationKey once, and your agent sends messages and runs campaigns through the operations the API already exposes. Operations are discovered on demand, so no extra tool definitions are loaded into the agent's context.

### Can I limit what my agent is allowed to do with the Campaigner API?

Yes. Write a rule that allows only the operations the agent needs, for example sending an SMS and creating an email campaign, and leave out higher-risk ones like deleting contacts or lists. The agent can then run campaigns while the actions you excluded stay unavailable, and every call it makes is logged.

### How do I send an SMS through Jentic with the Campaigner API?

Search Jentic for 'send an SMS', which returns the Campaigner single-SMS operation with its input schema, then supply the recipient number and message body and the agent runs it. To run it on your own infrastructure, install Jentic One from its GitHub repo.