# anymail developers

> Documentation of the anymail REST API v1 and MCP server. Base URL: https://app.anymail.watch/api/v1. Authentication: workspace API token as a Bearer header.

## Getting started

- [Overview](https://developers.anymail.watch/): The anymail REST API v1 and MCP server. Base URL, authentication, conventions and a map of every resource.
- [Quick start](https://developers.anymail.watch/quick-start/): Generate an API token, make a first request with curl and read the response.
- [Authentication](https://developers.anymail.watch/authentication/): How to generate a workspace API token, send it as a Bearer header and what a 401 response means.

## Concepts

- [Rate limits](https://developers.anymail.watch/rate-limits/): 60 requests per minute per token, the X-RateLimit headers and how to back off on a 429 response.
- [Errors](https://developers.anymail.watch/errors/): Status codes, error body shapes and the error codes returned by the prospect write endpoints.
- [Pagination](https://developers.anymail.watch/pagination/): Cursor pagination for every list endpoint, the limit parameter and the exceptions for companies, mailboxes and offers.
- [Idempotency keys](https://developers.anymail.watch/idempotency-keys/): Make POST requests safe to retry with the Idempotency-Key header, and what a replay returns.

## API reference

- [Prospects](https://developers.anymail.watch/prospects/): Create, list, get and update prospects. Parameters, request examples and response shapes.
- [Campaigns](https://developers.anymail.watch/campaigns/): List and get campaigns with progress and statistics, list enrolments, enrol prospects, pause and resume.
- [Companies](https://developers.anymail.watch/companies/): List companies with account temperature and get a company card with people, campaigns and recent events.
- [Replies](https://developers.anymail.watch/replies/): List classified replies and correct a classification. Parameters, filters and response shapes.
- [Offers](https://developers.anymail.watch/offers/): List sent offers with reading status and get one offer with its visits and reading time per page.
- [Suppressions](https://developers.anymail.watch/suppressions/): Exclude an address or a domain from sending, list the suppression list and remove an entry.
- [Webhook subscriptions (hooks)](https://developers.anymail.watch/webhook-subscriptions/): Subscribe a URL to an event with REST Hooks, list subscriptions and unsubscribe.
- [Mailboxes](https://developers.anymail.watch/mailboxes/): List the sending mailboxes of the workspace with status, daily limit and domain health. Credentials are never returned.

## Webhooks

- [Webhooks](https://developers.anymail.watch/webhooks/): Events, payloads, headers, HMAC-SHA256 signature verification in Node and Python, retries and idempotent handling.

## MCP

- [MCP server](https://developers.anymail.watch/mcp-server/): Connect Claude Code, Claude Desktop, Cursor or any MCP client to anymail with a Bearer token. All 23 tools and their limits.

## Reference

- [Limits and good practice](https://developers.anymail.watch/limits-and-good-practice/): Every numeric limit of the API in one table, and practical advice for retries, pagination and webhooks.
- [What the API does not do](https://developers.anymail.watch/what-the-api-does-not-do/): The operations and features that the anymail API does not offer, so that you can plan an integration around them.
- [Changelog](https://developers.anymail.watch/changelog/): Dated changes to the anymail REST API and MCP server.