API reference
REST API reference
The SendHeron REST API: 35 endpoints across contacts, tags, sequences, enrollments, templates, emails, and analytics. Scoped bearer tokens, documented rate limits.
Beta members get API keys with their account. There is no public signup while the beta is invite-only, so the keys arrive in the onboarding email rather than from a self-serve settings page.
Base URL
https://api.sendheron.com/api/v1Rate limits
60 per minute, 150 per 5 minutes, 300 per hour, 2000 per day. Every window applies at once, and the tightest one you breach is the one that rejects the request with a 429.
Authentication
Every request carries a bearer token. Keys are scoped, so a key that reads contacts cannot send email unless you grant it that too.
Authorization: Bearer <YOUR_API_KEY>- contacts:read
- contacts:write
- sequences:read
- sequences:write
- templates:read
- templates:write
- analytics:read
- emails:send
Endpoints (35)
Contacts13
Create, find and update the people you send to, plus their tags, events and engagement history.
GET/contactsPOST/contactsPUT/contactsGET/contacts/{id}PATCH/contacts/{id}DELETE/contacts/{id}GET/contacts/{id}/timelineGET/contacts/{id}/emailsPOST/contacts/{id}/tagsDELETE/contacts/{id}/tags/{tagId}POST/contacts/{id}/eventsPOST/contacts/{id}/sequences/{seqId}/enrollDELETE/contacts/{id}/sequences/{seqId}/unenroll
Sequences08
Read automation definitions, their steps, and how enrolled contacts are moving through them.
Enrollments02
Pause and resume a single contact's run through a sequence.
Templates05
Reusable email bodies with variable substitution.
Emails03
Send transactional, templated and bulk email directly.
Analytics02
Aggregate delivery and engagement figures.
Private beta
Keys come with the beta account
Join the list and your onboarding email carries a scoped key, the base URL, and a person to ask when something in here is wrong.