> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.mailercloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The Mailercloud API provides access to Mailercloud data and functionality — sync data, manage contacts and lists, create campaigns, and send email programmatically.

## 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](/api-reference)                             |
| **Email API** — transactional and personalized sending                          | `https://email-api.mailercloud.com`   | [Email API](/api-reference/email/send-email)                |
| **Email Verifier API** — verify addresses and clean lists                       | `https://verify.mailercloud.com`      | [Email Verifier](/api-reference/verification/verify-emails) |

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

<Note>
  One Marketing API endpoint has a newer v2 version with additional options — [Create Campaign (v2)](/api-reference/campaigns/create-campaign-v2), served under `/v2`. All other Marketing endpoints use `/v1`. See [Conventions & versioning](/conventions).
</Note>

## Get started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/guides/quickstart">
    Create a list, add a contact, and send your first campaign in five minutes.
  </Card>

  <Card title="Marketing API" icon="envelopes-bulk" href="/api-reference">
    Campaigns, contacts, lists, tags, segments, webhooks, automations and more — 56 endpoints.
  </Card>

  <Card title="Email API" icon="paper-plane" href="/api-reference/email/send-email">
    Send transactional email programmatically.
  </Card>

  <Card title="Use with AI tools" icon="robot" href="/ai-tools">
    Connect Claude, Cursor, or ChatGPT to these docs via MCP and llms.txt.
  </Card>
</CardGroup>

## Quick example

Create a contact list with a single request:

```bash theme={null}
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.

## We're here to help

<Tip>
  Questions? Reach us at [mailercloud.com/contact-us](https://www.mailercloud.com/contact-us) and we'll be happy to answer.
</Tip>