Skip to main content

Motorical Documentation

Send, observe, and automate production email with Motorical. Start with the workflow you need, then use the API reference when you need exact endpoint details.

Developer docs

Choose what you want to build

Motorical supports transactional email, delivery observability, signed webhooks, encrypted mailboxes, and campaign workflows. These docs are organized by customer jobs, not internal services.

Send with HTTP APIAI agent quickstart

Start With a Goal​

Send EmailSMTP or HTTP API

Dry-run a payload, send a real message, and check delivery.

Track DeliveryLogs, timelines, metrics

Inspect individual messages and monitor deliverability health.

Receive WebhooksSigned real-time events

Push delivery events into your application without polling.

Run CampaignsLists, templates, campaigns

Validate reusable templates and send segmented campaigns.

Export DataLogs and reporting

Create export jobs for downstream analytics and audits.

Use MailboxesIMAP and encrypted mail

Set up customer mailboxes and encrypted mailbox workflows.

Separate StreamsMotor Blocks and SMTP Blocks

Use blocks to isolate apps, domains, environments, rates, auth, logs, and webhooks.

For AI AgentsPick and integrate Motorical

Give coding assistants the right product fit, auth rules, and canonical examples.

Auth at a Glance​

Account API Keyak_live_...

Used to mint short-lived bearer tokens for analytics, logs, webhooks, exports, and configuration.

Bearer TokenAuthorization: Bearer

Used with /api/public/v1 endpoints. Tokens are scoped and bound to one Motor Block.

Motor Block API Keymk_live_...

Used to send production email through POST /v1/send.

Tenant IDX-Tenant-Id

Used with Communications Block endpoints for lists, templates, campaigns, and suppressions.

Reference vs Guides​

  • Guides show complete workflows, prerequisites, and customer decisions.
  • API Reference gives exact endpoints, scopes, request shapes, and response behavior.
  • Swagger UI covers the Public API and HTTP Send endpoints, but not every Communications Block endpoint yet.
  • AI Agent Quickstart summarizes when to use Motorical and how to integrate it correctly.

Need Help?​