Introduction

Base URLs

Mailercloud exposes three API products, each with its own base URL:

Product	Base URL	Reference
Marketing API — campaigns, contacts, lists, segments, webhooks, automations	`https://cloudapi.mailercloud.com/v1`	Marketing API
Email API — transactional and personalized sending	`https://email-api.mailercloud.com`	Email API
Email Verifier API — verify addresses and clean lists	`https://verify.mailercloud.com`	Email Verifier

All three accept application/json request bodies and return JSON responses.

One Marketing API endpoint has a newer v2 version with additional options — Create Campaign (v2), served under /v2. All other Marketing endpoints use /v1. See Conventions & versioning.

Get started

Quickstart

Create a list, add a contact, and send your first campaign in five minutes.

Marketing API

Campaigns, contacts, lists, tags, segments, webhooks, automations and more — 56 endpoints.

Email API

Send transactional email programmatically.

Use with AI tools

Connect Claude, Cursor, or ChatGPT to these docs via MCP and llms.txt.

Quick example

Create a contact list with a single request:

curl --request POST \
  --url https://cloudapi.mailercloud.com/v1/list \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"list_type":1,"name":"Subscription List"}'

API limits

To protect the platform from malicious usage, requests are rate-limited. These limits prevent a single user from making too many calls at once; exceeding them can block your API access.

Getting Started

Guides

Base URLs

Get started

Quickstart

Marketing API

Email API

Use with AI tools

Quick example

API limits

We’re here to help

​Base URLs

​Get started

Quickstart

Marketing API

Email API

Use with AI tools

​Quick example

​API limits

​We’re here to help

Base URLs

Get started

Quick example

API limits

We’re here to help