Introduction
Connect your own systems to Alienmail with the REST API and the MCP server.
Alienmail sends cold email campaigns from your own mailboxes. The API lets your CRM, product or back office work with it directly, so the right people are in the right campaign without anyone uploading a file.
What you can build
- Keep campaign leads in step with your CRM. Add people to a campaign when they match a segment, update their details, and stop or remove them when they convert.
- Control campaigns. List your campaigns, and start or pause one from your own tools.
- Manage mailboxes. See which mailboxes are connected and healthy, change a daily sending limit, or turn a mailbox off.
- Let an AI assistant do it. The Alienmail MCP server gives tools like Claude and Cursor the same abilities.
- Connect your own app or agent. Your users sign in to Alienmail from your app, and it works in their workspace through the MCP server. See Connect your own app.
Base URL
All endpoints live under one base URL. Requests and responses are JSON over HTTPS.
https://app.alienmail.io/api/v1Start here
Quickstart
Create an API key and make your first requests in a few minutes.
Authentication
API keys, roles and the permission each endpoint needs.
Sync leads
Add, update, stop and remove the people a campaign emails.
Alienmail MCP server
Work with your account from Claude, Cursor and other AI tools.
Connect your own app
Sign your users in to the MCP server with OAuth, or use an API key.
API reference
Every endpoint, with a playground to try it with your key.
AI tools and MCP
Use these docs from ChatGPT, Claude, Cursor and other AI tools.
For tools and AI agents
/openapi.json: the OpenAPI 3.1 spec. Import it into Postman or Insomnia, or generate a client./llms.txtand/llms-full.txt: these docs for language models.- Every page has a Markdown version: add
.mdto its URL, or use Copy page at the top.