
What it does
POST /mail/v1/send queues one transactional email per call, from a Hyo Mail template with variables or from your own HTML.
Read the message log and each message's delivery events.
Create or update contacts with their consent, list contacts and active sign-up forms.
Record orders and other conversions for campaign attribution. An OpenAPI 3.0 document is published at /mail/v1/openapi.json.
Who it is for
Developers who want receipts, confirmations and account notices from their product sent through Hyo Mail.
How to connect it
Verify your sending domain and add a sender in Hyo Mail.
Create an API key in Mail › Automations › API keys, with only the scopes it needs.
Call https://api.hyonova.com with the header Authorization: Bearer and your key.
Send an Idempotency-Key with each send, so a retry never sends the same email twice.
What you need
A verified sender on your own domain.
Mail credits: each message uses one credit.
Mail administration to create API keys (Owners and admins by default). The API is included in every plan.
Limits
This is the Hyo Mail API. Apart from SCIM user provisioning on the Enterprise plan, work, customers and meetings in HyoNova are used through the web app, not through a public API.
600 requests per minute per key (300 for conversions), with rate-limit headers on every answer.
No SMTP relay, and no endpoints for campaigns or lists.
A key is shown once and is stored only as a hash. Keep it on your servers.
Full guide: Mail API reference