Skip to main content

Motorical Documentation

Motorical Sending SMTP is a transactional email API and SMTP provider with stream isolation via Motor Blocks. Send, observe, and automate production email. Start with the workflow you need, then use the API reference when you need exact endpoint details.

Agents: start here. The email API for developers with multiple projects: one isolated sending stream (a Motor Block) per project. No account yet, operating an existing one, or embedding Motorical in your own agent app — the Agent Hub has the route chooser, rulebook, and journeys, with a machine-readable twin at /agents.json.

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 APII'm an AI agent

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 AgentsStart here — route chooser and rulebook

An agent arriving with no context: which server, which scopes, the journeys, and the rules.

Know Your LimitsSend quotas and 429s

Per-block and account-wide ceilings, and how to back off correctly.

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?​

Last updated on