Developers

Build with HyoNova

Connect your systems to Hyo Mail: send transactional email and sync contacts with the REST API, receive signed webhooks, or connect WordPress and WooCommerce without code.

  • REST API with scoped API keys
  • Signed webhooks with automatic retries
  • WordPress and WooCommerce plugin
A laptop showing code, connected to cloud, database and settings blocks.

At a glance

What can I build?

Your systems can send transactional email through Hyo Mail, read delivery events, create contacts with their consent and record orders. Hyo Mail calls your endpoint with signed webhooks.

Who is it for?

Developers and IT teams connecting a product, an online store or a data system to Hyo Mail.

How is it priced?

The Mail API and webhooks are included in every plan. Each email you send uses one Mail credit.

What you can use

Transactional email API

Send receipts, confirmations and account notices, one message per call, from a template with variables or your own HTML.

Message log and events

Read each message's status and delivery events, and filter the log by status, recipient, tag or date.

Contacts with consent

Create or update contacts by email with their consent status, and list contacts and sign-up forms.

Conversions

Record orders and other conversions so campaign revenue is attributed to the right email.

Signed webhooks

Receive delivery, engagement, contact, conversion and store events, signed with HMAC-SHA256.

WordPress and WooCommerce plugin

Double opt-in sign-up forms and store sync, connected with an API key and no code.

Scoped API keys

Give each integration only the scopes it uses. Keys are shown once, stored as a hash and can be revoked instantly.

OpenAPI document

A machine-readable OpenAPI 3.0 description of the Mail API at /mail/v1/openapi.json.

Get started in four steps

Verify your domain

In Hyo Mail, verify your sending domain with DNS records and add a sender.

Create an API key

Open Mail › Automations › API keys and select only the scopes you need.

Send your first email

Call POST https://api.hyonova.com/mail/v1/send with your key and an Idempotency-Key.

Listen for events

Add a webhook in Mail › Automations › Webhooks and verify each signature.

Questions and answers

Is the API included in my plan?

Yes. Every plan includes the Mail API and webhooks. Each message you send uses one Mail credit.

Do I need a library to use it?

No. The API is plain HTTPS and JSON. The documentation has cURL, Node.js and PHP examples, and the OpenAPI document can generate a client in your language.

What is the base URL?

https://api.hyonova.com. Every call sends an API key as a bearer token.

Can I connect WordPress without writing code?

Yes. Install the Hyo Mail plugin, paste an API key and connect. WooCommerce sync uses the same plugin.

Start building on Hyo Mail

Create your company for free, verify your domain and send your first email from your code.