Send a single email through SendHustle (POST /emails). Supports HTML and/or plain text, CC/BCC, reply-to, scheduling, attachments, tags, and custom headers. The "from" address must be on a verified domain; if omitted, the server default sender is used.

Retrieve a sent email and its events by id (GET /emails/:id).

List sent emails with cursor pagination (GET /emails).

Create a sender domain (POST /domains). The response includes DNS records you must add at your DNS provider before verifying.

List sender domains (GET /domains).

Create an audience — a named list of contacts (POST /audiences).

List audiences (GET /audiences).

Create a contact in a sending domain's contact pool (POST /contacts, domain-first). The same address on two domains is two records with separate consent.

List a sending domain's contacts (GET /contacts?domain=..., domain-first). Optional segment_id restricts to that segment's members.

Create a campaign targeting a sending domain's contact pool (POST /campaigns, domain-first). Send it later with send_campaign.

Send a campaign now, or schedule it with scheduled_at (POST /campaigns/:id/send).

Send up to 100 emails in one request (POST /emails/batch). Pass an array of email objects, each with from/to/subject and html and/or text. Per-email "from" defaults to the configured sender if omitted.

Reschedule a scheduled email by setting a new send time (PATCH /emails/:id).

Cancel a scheduled email before it sends (POST /emails/:id/cancel).

List a sent email's attachments (GET /emails/:id/attachments).

Retrieve metadata for one attachment of a sent email (GET /emails/:id/attachments/:attachmentId). Returns a download_url for the file.

List inbound (received) emails with cursor pagination (GET /emails/receiving).

Retrieve a single received email by id (GET /emails/receiving/:id).

Download the original RFC822/MIME message of a received email (GET /emails/receiving/:id/raw). Returns the raw message as text.

Forward a received email to other recipients (POST /emails/receiving/:id/forward). "from" must be a verified sending address; defaults to the configured sender.

List a received email's attachments as metadata with download URLs (GET /emails/receiving/:id/attachments).

Retrieve metadata for one attachment of a received email, including its download_url. (GET /emails/receiving/:id/attachments/:attachmentId serves the raw bytes; this tool returns the matching metadata entry from the attachment list instead.)

Permanently delete a received email, including its stored raw message and attachments (DELETE /emails/receiving/:id). This cannot be undone.

Retrieve a domain, including its DNS records and verification status (GET /domains/:id).

MX preflight for a hostname before enabling receiving (GET /domains/mx-check). Returns { has_mx, ours, records } — whether the hostname already has MX records and whether they all point at our inbound host.

Update a domain's tracking/TLS/capabilities settings (PATCH /domains/:id).

Trigger verification of a domain after its DNS records are in place (POST /domains/:id/verify).

Delete a domain (DELETE /domains/:id).

Claim a domain already verified elsewhere (POST /domains/claim). Returns a TXT record to add.

Detect a domain's DNS provider and the one-click apply methods available (GET /domains/:id/dns/detect).

Apply a domain's DNS records via the Cloudflare API, then auto-verify (POST /domains/:id/dns/cloudflare). Requires a scoped Zone.DNS:Edit token.

Apply a domain's DNS records via the GoDaddy API, then auto-verify (POST /domains/:id/dns/godaddy).

Apply a domain's DNS records via the Namecheap API, then auto-verify (POST /domains/:id/dns/namecheap). Namecheap requires the calling server's IP to be whitelisted on the account.

Retrieve the current claim (and its TXT verification record) for a placeholder domain (GET /domains/:id/claim).

Trigger DNS verification for a pending domain claim (POST /domains/:id/claim/verify).

Retrieve an audience by id (GET /audiences/:id).

Rename an audience (PATCH /audiences/:id).

Delete an audience and its contacts (DELETE /audiences/:id).

Retrieve a contact (GET /contacts/:id). A contact id is exact; an EMAIL can exist in several domains' pools, so pass domain to pick the pool.

Update a contact by id or email (PATCH /contacts/:id). Pass domain when addressing by EMAIL (picks the pool).

Delete a contact by id or email (DELETE /contacts/:id). Pass domain when addressing by EMAIL (picks the pool).

Add a contact to a segment (POST /contacts/:id/segments/:segmentId).

List the segments a contact belongs to (GET /contacts/:id/segments).

Remove a contact from a segment (DELETE /contacts/:id/segments/:segmentId).

Get a contact's topic subscriptions (GET /contacts/:id/topics).

Update a contact's topic subscriptions (PATCH /contacts/:id/topics). Provide topics as an array of { id, subscription: 'opt_in' | 'opt_out' }.

Create a custom contact property / merge tag (POST /contact-properties). type is 'string' or 'number'. Idempotent on key: if a property with the same key already exists, returns that property (with already_existed: true) instead of an error.

Reply to a received email's sender, threaded into the same conversation (POST /emails/receiving/:id/reply). from must be on a verified domain.

Import contacts from a link-shared Google Sheet (POST /audiences/:id/contacts/import-sheet). Sheet headers become contact properties usable as {{merge_tags}}; rows land in a fresh segment.

Bulk-import contacts from a JSON array (POST /audiences/:id/contacts/batch). Upserts by email; max 10,000 per call. Each contact: { email, first_name?, last_name?, unsubscribed?, properties? }.

Bulk-import contacts from CSV text (POST /audiences/:id/contacts/import). Header row optional; the email column is required. Non-builtin columns auto-register as custom properties unless create_properties is false. Max 5 MB / 10,000 rows.

List emails that have in-email poll responses, with per-email counts (GET /polls).

Get the aggregated answer breakdown for one email's poll (GET /polls/:emailId).

List contact properties (GET /contact-properties).

Retrieve a contact property by id (GET /contact-properties/:id).

Update a contact property's fallback value (PATCH /contact-properties/:id). key/type are immutable.

Delete a contact property (DELETE /contact-properties/:id).

Create a segment on a sending domain (POST /segments, domain-first). Segment names are unique WITHIN a domain but reusable across domains. filter supports { status, email_contains, property_filters }.

List a sending domain's segments (GET /segments?domain=...). Every domain includes an auto-created "General" (all contacts) segment.

Retrieve a segment by id (GET /segments/:id).

Preview the contacts a segment currently resolves to (GET /segments/:id/contacts).

Update a segment's name or filter (PATCH /segments/:id).

Delete a segment (DELETE /segments/:id).

Create a subscription topic on a sending domain (POST /topics, domain-first). default_subscription is 'opt_in' or 'opt_out'; visibility is 'public' or 'private'.

List a sending domain's subscription topics (GET /topics?domain=...).

Retrieve a topic by id (GET /topics/:id).

Update a topic (PATCH /topics/:id).

Delete a topic (DELETE /topics/:id).

Retrieve a campaign by id (GET /campaigns/:id).

Per-campaign analytics — counts, engagement rates, and top clicked links (GET /campaigns/:id/stats).

A/B winner evaluation for an A/B-test campaign (GET /campaigns/:id/ab).

List campaigns (GET /campaigns).

Update a draft campaign's content or targeting (PATCH /campaigns/:id).

Cancel a scheduled campaign, returning it to draft (POST /campaigns/:id/cancel).

Delete a campaign (DELETE /campaigns/:id).

Create a reusable email template (POST /templates). Supports subject/html/text with {{ variables }} and optional variable definitions.

List templates (GET /templates).

Retrieve a template by id (GET /templates/:id).

Update a template (PATCH /templates/:id).

Duplicate a template (POST /templates/:id/duplicate).

Publish a template, making its latest draft live (POST /templates/:id/publish).

Delete a template (DELETE /templates/:id).

Create an automation triggered by an event (POST /automations). Every automation belongs to one sending domain — only send_event calls with the same domain trigger it. Optionally pass an inline step graph (steps + connections).

List automations (GET /automations).

Retrieve an automation, including its step graph (GET /automations/:id).

Append a step to an automation (POST /automations/:id/steps).

Update a step in place (PATCH /automations/:id/steps/:stepId). The graph key stays stable, so connections keep pointing at it. Disable the automation first if it is enabled.

Delete a step from an automation (DELETE /automations/:id/steps/:stepId). Stop (disable) the automation first if it is enabled.

Update an automation's name, status, domain, or connection graph (PATCH /automations/:id). Enabling requires at least one step; editing connections or the domain requires the automation to be disabled.

List an automation's runs (GET /automations/:id/runs). Filter with status (comma-separated: running,completed,failed,cancelled,skipped).

Retrieve a single automation run, including its step-by-step trace (GET /automations/:id/runs/:runId).

Stop an automation — prevents new runs; in-progress runs finish (POST /automations/:id/stop).

Delete an automation (DELETE /automations/:id).

Create a webhook endpoint (POST /webhooks). The signing secret is returned ONCE on create — store it.

List webhooks (GET /webhooks).

Retrieve a webhook by id (GET /webhooks/:id).

Update a webhook's endpoint, events, or status (PATCH /webhooks/:id).

Delete a webhook (DELETE /webhooks/:id).

Rotate a webhook signing secret (POST /webhooks/:id/rotate). The new secret is returned ONCE; the old secret stops verifying immediately.

Send a synchronous test delivery and return the endpoint's live result (POST /webhooks/:id/test).

Locally verify a webhook delivery's Svix-style signature (no API call). Provide the exact raw request body, the svix-id/svix-timestamp/svix-signature headers, and your endpoint signing secret. Returns { valid, reason? }.

List API request logs (GET /logs).

Retrieve a single API log entry, including request/response bodies (GET /logs/:id).

Send a custom event that automations can trigger on (POST /events/send). domain is required — only automations belonging to that sending domain are triggered. Identify the contact by contact_id OR email.

Create a custom-event definition (POST /events). Optional flat schema (key → 'string'|'number'|'boolean'|'date') validates /events/send payloads (422 on mismatch).

List custom-event definitions (GET /events).

Update a custom-event definition's payload schema (PATCH /events/:id). The event NAME is immutable (renaming would detach automations that reference it) — create a new event to rename. Pass schema as a flat key→type map, or null to clear it.

Delete a custom-event definition (DELETE /events/:id). Existing automations keep their trigger names; this only removes the definition + its payload validation.

Create an API key (POST /api-keys). The token is returned ONCE. permission is 'full_access' or 'sending_access'.

List API keys (GET /api-keys).

Delete (revoke) an API key (DELETE /api-keys/:id).