The Winnr API is a REST API at https://api.winnr.app/v1. Bearer-token auth (create tokens from Settings → API Keys). Supports every core operation — provision domains, create mailboxes, enable warming, export credentials, read replies. Startup plan gets 300 req/min, Enterprise gets 500. Full OpenAPI spec at app.winnr.app/docs and public download from the marketing site.
When to use the API vs. the UI
Use the UI when: - Setting up your account for the first time. - One-off changes (new domain, tweak warming settings). - Reading metrics and dashboards.
Use the API when: - Provisioning at scale (10+ domains in a batch). - Automating recurring tasks (weekly export to sending tool). - Building on Winnr (AI SDR pipelines, custom dashboards, whitelabel apps). - Integrating with your CRM or ops workflow.
Two ways to hit the API
- Direct HTTP. Any language, any client. Use the OpenAPI spec to generate a client SDK if you want typed calls.
- MCP server. For AI agents (Claude, Cursor, Claude Code). Same operations, exposed as 37 tools an LLM can call directly. See MCP setup.
Quick example
Create a mailbox with curl:
curl -X POST https://api.winnr.app/v1/email-users \
-H "Authorization: Bearer wnr_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"domain": "yourdomain.com",
"local_part": "sam",
"display_name": "Sam Chen"
}'
Response includes the SMTP/IMAP credentials for the new mailbox.
What's next
Frequently asked questions
What can I do with the API?
Everything you can do in the UI. Provision domains, create mailboxes, enable warming, adjust settings, export credentials, read replies, manage tags, purchase pre-warmed marketplace domains — full coverage.
What's the base URL?
https://api.winnr.app/v1
What auth does it use?
Bearer tokens. Add "Authorization Bearer YOUR_TOKEN" as an HTTP header. Tokens are created in Settings → API Keys with read/write scopes.
Is the API included in Startup?
Yes. Both plans get full API access. Only rate limits differ — 300 req/min on Startup, 500 on Enterprise.
Where's the full spec?
OpenAPI 3.1 spec at [app.winnr.app/docs](https://app.winnr.app/docs). Interactive explorer built in.