The whole API, endpoint by endpoint

One REST API over transactional sending, campaigns, automation, and the contact graph they share. Every page below is generated from the API’s own OpenAPI document, so it describes what the service actually serves — not a copy of it that drifted.

Base URL

https://api.volanea.com

Endpoints

92

Auth

Bearer sk_…

Version

0.1.0

Your first call

Every endpoint takes a project API key as a bearer token. sk_… is server-side only; sk_test_… renders and logs but never delivers; pk_… is safe in client code and is accepted only by POST /v1/events.

cURL

curl https://api.volanea.com/v1/send \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "ada@example.com",
    "subject": "Your order shipped",
    "html": "<p>On its way, {{firstName}}.</p>"
  }'

Send

2 endpoints

Transactional sending, with batching, scheduling, and idempotency.

Events

6 endpoints

Product event ingestion (public key) and the event log.

Contacts

13 endpoints

The contact graph: CRUD, timeline, bulk operations, CSV import/export.

Emails

3 endpoints

The send log — every message across all sources.

Templates

9 endpoints

Reusable content with versioning, rollback, and test sends.

Domains

5 endpoints

Sending domains, DNS records, and verification.

Segments

10 endpoints

Dynamic (condition-driven) and static audiences.

Campaigns

13 endpoints

One-off broadcasts with scheduling, A/B subjects, and engagement stats.

Workflows

11 endpoints

Event-triggered automation graphs and their executions.

Webhooks

6 endpoints

Signed event deliveries to your endpoints, with retries and replay.

Suppressions

5 endpoints

The do-not-send list: bounces, complaints, unsubscribes, and manual blocks.

Stats

2 endpoints

Engagement aggregates: the project rollup and the per-workflow funnel.

Verify

1 endpoint

Email address validation.

Billing

2 endpoints

Usage, monthly caps, reputation, and invoices.

Inbound

2 endpoints

Inbound mail ingestion (used by the SMTP relay).

Meta

2 endpoints

API metadata.