primitive docs
primitive app

Introduction

Primitive is programmatic email: send outbound mail with one HTTPS call, receive inbound mail as JSON via webhook or REST. Two surfaces, one product, one API key.

Every account gets a managed *.primitive.email subdomain that's verified by construction. Bring your own domain when you're ready. Official SDKs and a CLI ship for Node.js, Python, and Go.

How it fits together

  1. Sign up. You get a managed *.primitive.email subdomain immediately. Inbound and outbound work out of the box.
  2. (Optional) Add your domain. Publish MX (and DKIM/SPF/DMARC/TLS-RPT for outbound) and Primitive verifies them automatically.
  3. Set a webhook URL. One URL per org. Every inbound email POSTs there as JSON.
  4. Install an SDK. Node, Python, or Go. The SDK verifies signatures, parses payloads, and exposes a typed client for sending.

Next steps

  • Quickstart: send and receive your first emails in five minutes.
  • Sending mail: outbound concepts including gates, limits, idempotency, threading.
  • Receiving mail: webhook flow, retries, replays, idempotency.
  • REST API: complete reference for every v1 endpoint.
  • Webhook Payload: full inbound schema with examples.
  • Signature Verification: secure your webhook endpoint.
  • SDKs: install commands and per-language details.
  • CLI: one-shot operations from the terminal.