Aiosis Emails
Send transactional email, manage contacts and lists, run campaigns, and read delivery and engagement events — over a REST API scoped to your account by an API key.
https://emails.aiosis.com/api/v1Every request carries a bearer key. Create one in the app under Settings → API keys; it is shown once and stored only as a SHA-256 hash, so it cannot be recovered — create a new one instead.
Authorization: Bearer sk_live_xxxxxx_…A key belongs to exactly one account and carries a subset of these scopes.
A call outside its scopes is refused with 403, never silently
narrowed.
contacts:readcontacts:writecampaigns:readcampaigns:writemessages:sendstats:readmessages:readtemplates:readtemplates:writeevents:writedomains:readwebhooks:managemail:readmail:sendThe transactional endpoint. Needs the messages:send scope.
curl -X POST https://emails.aiosis.com/api/v1/messages \
-H "Authorization: Bearer $AIOSIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "customer@example.com",
"subject": "Your receipt",
"html": "<p>Thanks for your order.</p>",
"text": "Thanks for your order.",
"fromEmail": "billing@yourdomain.com",
"fromName": "Acme Billing",
"replyTo": "support@yourdomain.com",
"tags": ["receipt"]
}'Every message the API accepts gets a record you can read back, and opens and clicks are tracked first-party — a pixel and rewritten links on this domain, not a third party's.
GET /api/v1/events — delivery, open, click, bounce and complaint events.GET /api/v1/campaigns/{id}/stats — per-campaign aggregates.GET /api/v1/suppressions — who must not be mailed, and why.The same data drives the dashboard in the app, so what you read over the API is what the interface shows.
Register an endpoint with POST /api/v1/webhooks. Deliveries are
signed so you can verify they came from us:
X-Aiosis-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "<unix>.<raw body>">
X-Aiosis-Event: contact.subscribed
X-Aiosis-Delivery: whk_…Compute the HMAC over <timestamp>.<raw body> with the endpoint
secret and compare in constant time. Reject anything older than five minutes.
Delivery is at-least-once, so deduplicate on the payload id.
A failing endpoint is retried with exponential backoff for 24 hours, then
dead-lettered and replayable.
Collections are cursor-paged. Follow nextCursor until it is
null; a short page means the end.
600 requests per minute per key, so one
integration cannot starve another. Every response carries X-RateLimit-Remaining.
JSON with a message. An object belonging to another account
is 404, not 403, so ids stay unenumerable.
42 endpoints
Generated from the same definition that serves the OpenAPI document, so it cannot drift from the running API.
GET | /api/v1/contacts | List contacts | contacts:read |
POST | /api/v1/contacts | Create or update a contact | contacts:write |
GET | /api/v1/contacts/{id} | Fetch one contact | contacts:read |
PATCH | /api/v1/contacts/{id} | Update a contact | contacts:write |
DELETE | /api/v1/contacts/{id} | Erase a contact (GDPR) | contacts:write |
POST | /api/v1/contacts/{id}/unsubscribe | Unsubscribe a contact | contacts:write |
GET | /api/v1/contacts/{id}/subscriptions | A contact's subscription to every category | contacts:read |
PUT | /api/v1/contacts/{id}/subscriptions | Record subscription choices made in your own UI | contacts:write |
GET | /api/v1/lists | List mailing lists | contacts:read |
POST | /api/v1/lists | Create a mailing list | contacts:write |
GET | /api/v1/lists/{id}/contacts | List the subscribed contacts of a list | contacts:read |
GET | /api/v1/campaigns | List campaigns | campaigns:read |
POST | /api/v1/campaigns | Create a campaign | campaigns:write |
GET | /api/v1/campaigns/{id} | Fetch one campaign | campaigns:read |
POST | /api/v1/campaigns/{id}/send | Send a campaign now | campaigns:write |
POST | /api/v1/campaigns/{id}/schedule | Schedule a campaign | campaigns:write |
POST | /api/v1/campaigns/{id}/pause | Pause a sending campaign | campaigns:write |
POST | /api/v1/campaigns/{id}/cancel | Cancel a campaign | campaigns:write |
GET | /api/v1/campaigns/{id}/stats | Campaign performance | stats:read |
POST | /api/v1/messages | Send an email | messages:send |
POST | /api/v1/messages/batch | Send one template to many recipients | messages:send |
GET | /api/v1/messages/{id} | Fetch one message, its events and its failure reason | messages:read |
GET | /api/v1/templates | List templates, every locale | templates:read |
POST | /api/v1/templates | Create a template, or a new locale of a key | templates:write |
GET | /api/v1/templates/{key} | Every locale of one template key | templates:read |
PATCH | /api/v1/templates/{key} | Edit one locale of a template | templates:write |
DELETE | /api/v1/templates/{key} | Delete a template (one locale, or all) | templates:write |
POST | /api/v1/templates/{key}/publish | Publish the current draft | templates:write |
POST | /api/v1/templates/{key}/preview | Render a template without sending | templates:read |
POST | /api/v1/templates/{key}/test | Send the draft to one address | templates:write |
GET | /api/v1/categories | Email categories a recipient can opt into or out of | contacts:read |
GET | /api/v1/suppressions | List suppressions | contacts:read |
POST | /api/v1/suppressions | Suppress an address | contacts:write |
POST | /api/v1/imports | Import contacts from CSV | contacts:write |
GET | /api/v1/webhooks | List webhook endpoints | campaigns:read |
POST | /api/v1/webhooks | Register a webhook endpoint | campaigns:write |
PATCH | /api/v1/webhooks/{id} | Update a webhook endpoint | campaigns:write |
DELETE | /api/v1/webhooks/{id} | Delete a webhook endpoint | campaigns:write |
POST | /api/v1/webhooks/{id}/rotate | Rotate an endpoint signing secret | campaigns:write |
GET | /api/v1/webhooks/deliveries | List dead-lettered deliveries | campaigns:read |
POST | /api/v1/webhooks/deliveries/{id}/replay | Replay a dead-lettered delivery | campaigns:write |
POST | /api/v1/events | Record a custom event | contacts:write |