Manage everything through the REST API — or let an AI agent do it via the MCP Server.
A tour of the Winnr REST API by resource. Account, domains (including custom DNS records and DMARC), email users, warming, inbox, export, jobs, pre-warmed marketplace, webhooks and message lookup, API tokens, team users and templates. Full OpenAPI spec at app.winnr.app/docs.
Startup gets 300 API requests per minute and Enterprise 500, shared across all of an account's tokens. Short bursts above that are absorbed. Past the burst cap the API returns 429 with a Retry-After header. Exports are limited to one every 5 seconds.
The Winnr MCP server gives Claude (web, mobile and desktop), ChatGPT, Cursor, Windsurf, VS Code and Claude Code 55 tools for managing your cold email infrastructure in plain language. Add https://mcp.winnr.app/mcp as a connector and sign in. Setup takes about 30 seconds.
Create API tokens on the API page in the app. Give each one Read, or Read and Write, permission. Tokens start with wnr_ and are shown once, so copy them immediately. Revoke any time from the same page.
Winnr has a REST API for managing domains, mailboxes, warming, the inbox, exports, pre-warmed domains and webhooks programmatically. Bearer-token auth, JSON, full OpenAPI spec. API access is included on every plan; only rate limits differ.
Register HTTPS endpoints to receive signed event notifications from Winnr, including message.relayed events that map your Message-ID to the one the upstream email provider assigns. Verify signatures, handle retries, and look up mappings via GET /v1/messages/lookup.