Guides: SMTP/IMAP email API and webhooks

How to use Smapiz to send and receive email over an API, step by step.

• Tutorial: send and receive emails over an API with Smapiz

  Connect a mailbox, create an API key, send an email with curl and receive inbound emails as webhooks: the complete tutorial in 5 steps.

• Connect Claude, ChatGPT or Cursor to your mailbox (MCP)

  Let your AI assistant read, search and answer your emails: paste one URL, sign in, done. No API key to copy. Setup for Claude, ChatGPT, Cursor and Claude Code.

• Connect an SMTP/IMAP mailbox (Gmail, Outlook, OVH…)

  SMTP and IMAP settings for Gmail, Microsoft 365, OVH, IONOS or your own server: app passwords, ports, security and receiving options.

• Send an email over a REST API with your SMTP mailbox

  POST /v1/messages: recipients, HTML, attachments, scheduled sending and idempotency. Copy-paste curl examples to send from your own SMTP mailbox.

• Receive inbound emails as webhooks (IMAP to JSON)

  Every email received over IMAP is POSTed as JSON to your URL: events, payload format, HMAC signature verification in Node.js and retries.

• Reply to an email over the API in the same thread

  Answer a received email with POST /v1/messages/{id}/reply: In-Reply-To, References and “Re:” handled automatically, reply-all and thread_id.

• Email templates with variables

  Create a reusable email template, insert {{ first_name }} variables with default values and send it over the API with template_id.

• API keys, permissions and team

  Create an API key restricted to sending or reading, revoke it in one click and invite your team with the member, admin and owner roles.