Developer API

Your whole stack, finally in sync

Connect Maildesk to your booking tools, checkout, and course platform with a full REST API on every paid plan. Information flows where it needs to — no copy-paste, no silos.

No credit card needed

Building an integration? Read the API docs

  • Booking tool
  • Checkout
  • Course platform
Your booking tool → Maildesk
POST /v1/contacts
{ "email": "…", "tags": ["Booked a call"] }
→ 201 Created

New booking? They’re tagged and in the right segment before you’ve hung up.

Booked a call · 84
Full REST API on every paid plan · docs your developer (or VA) can actually use

What you get

  • Full REST API on every paid plan
  • Sync subscribers, tags, and events
  • Connect booking tools, checkout, and your course platform
  • Clear docs your developer (or VA) can actually use

Why a service business needs an email API

Your clients do not live in one tool. They book in a calendar app, pay through a checkout, learn inside a course platform, and hear from you by email. When those systems cannot talk to each other, someone copies names between them by hand, and the follow-up that should have started the moment a call was booked starts whenever that person gets around to it. The Maildesk API removes the copying. A booking creates or updates the subscriber and applies a tag. A purchase moves them into the client segment. A course completion starts the sequence that asks for a referral. Your stack stays in sync and your automations fire on real events.

How the API works

It is a straightforward REST API with JSON in and JSON out. Create, update, list and delete subscribers; add and remove tags; bulk-import contacts with per-record results so a single bad row never fails the batch; and subscribe to webhooks for subscriber events, signed with HMAC so you can verify every payload. API keys live in your workspace settings, and the documentation includes copy-paste examples for the common jobs, so a developer or a technically minded VA can wire up your booking tool in an afternoon.

What makes the Maildesk API different

Many platforms lock API access behind enterprise tiers, so a solo practice never gets it. Maildesk includes the full API on every paid plan, starting with Starter. The API is also a first-class part of the product rather than an afterthought: every tag you add through it can trigger an automation, feed a segment, and show up in analytics exactly as if you had added it by hand.

Developer API FAQs

Which plans include API access?
The full REST API is included on every paid plan, from Starter upwards. There are no separate API tiers and no additional fees for API calls within normal use.
Where do I find my API key?
Go to Settings and then API Keys in your Maildesk workspace. Every business has pre-issued keys ready to use, and the team, webhooks and API keys guide below walks through them.
Does Maildesk support webhooks?
Yes. Create a webhook with your endpoint URL, choose the subscriber events you want, and Maildesk posts a signed JSON payload to your endpoint in real time. Every delivery is logged so you can inspect the exact payload, and you should verify the HMAC signature against the raw request body before trusting it.
Can I trigger an automation through the API?
Yes. Add a tag to a subscriber through the API and any automation that triggers on that tag starts immediately, the same as if the tag were applied from a form or by hand.