Developer API

A REST API for integrating email marketing into your applications. Manage lists, subscribers, campaigns, statistics and events that trigger automations.

Main endpoints

Everything you need to manage email marketing programmatically.

Lists

Create, list, update and delete subscriber lists. Retrieve statistics and custom fields for each list.

Subscribers

Add, find, update and manage subscribers. Review activity history and received campaigns.

Campaigns

List campaigns, retrieve detailed statistics, export activity logs, and pause or resume sends.

Statistics

Open, click, bounce, spam-complaint, geolocation and device metrics for each campaign.

External events

Record events from your app, CRM, ecommerce or website to trigger automations and retain interaction history.

Senders

Manage sender addresses, verify DNS status (SPF/DKIM) and create verified senders.

Custom fields

Create, edit and delete custom list fields, including text, dropdown, radio, date and multiline fields.

Simple authentication

Use your API key as a bearer token on every request. No complicated OAuth or multi-step authorization flows.

  • API key as a bearer token
  • HTTPS required for every endpoint
  • JSON responses
  • Transparent rate limiting with headers
  • Optional authorized-IP restriction
JavaScript 
// Retrieve subscriber lists
const response = await fetch('https://fleetmailer.com/api/v1/lists', {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data.lists);
cURL 
curl -X POST https://fleetmailer.com/api/v1/lists/5AZD/subscribers \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "nuevo@ejemplo.com",
    "name": "John Smith",
    "confirmado": true
  }'
NEW

MCP integration

Fleetmailer supports the Model Context Protocol (MCP), the open standard for connecting AI agents with external services.

Connect your account with AI agents such as Claude and GPT to query campaigns, review statistics, create safe content and manage lists or subscribers from your preferred tools.

  • AI-assisted list and subscriber management
  • Natural-language statistics queries
  • Advanced automation with autonomous agents
Events and webhooks

Connect your systems with automation

External events let your ecommerce, CRM, app or website notify Fleetmailer when something important happens: a purchase, registration, upgrade, download, event attendance or abandonment.

  • Custom events over HTTP
  • Temporary fields for personalizing journey emails
  • Contact-level event history
  • Real-time automation triggers
External event 
POST /v3/api/events/record

eventName=compra
eventValue=premium
email=cliente@ejemplo.com
listid=TU_LISTID
pf_order_id=ORD-123

Start integrating email marketing into your app

Create a free account and get your API key to start building.

Create a free account