Norbelys API Documentation

The Norbelys API lets you build on top of the platform — automate contact imports, trigger sends, query analytics, and manage deliverability from your own code or AI agents.

What you can do

Send email

One unified send door for cold outreach, sequences, and one-off sends.

Manage contacts

Create contacts, update custom fields, and read full per-contact timelines.

Run programs

Launch campaigns and sequences with steps, A/B variants, and enrollments.

Query analytics

Named catalog queries over the event store — funnels, feeds, A/B results, DMARC.

API design

Five predictable patterns — every endpoint is one of these:

Pattern	Shape	Example
Resource	`GET/POST /{plural}`, `GET/PATCH/DELETE /{plural}/{id}`	`/contacts`
Relationship	`GET/POST /{owner}/{id}/{rel}`, `DELETE /{owner}/{id}/{rel}/{relId}`	`/programs/{id}/senders`
View	`GET /{plural}/{id}/{name}`	`/messages/{id}/source`
Action	`POST /{plural}/{id}/{name}`	`/programs/{id}/launch`
Collection action	`POST /{plural}/{name}`	`/senders/verify`

Other conventions:

Base URL — https://api.norbelys.com/v1
JSON in, JSON out. Timestamps are ISO-8601 in UTC.
Explicit pagination. Lists are cursor-based by default; offset-indexed feeds advertise and return page + total.
Predictable errors. { error: { code, message } } with the matching HTTP status.
Soft deletes. DELETE archives, never hard-deletes — returns the archived row.
Expansions. Some detail GETs accept ?expand[]= for related objects inline.

Get started

Reference

Norbelys API Documentation

What you can do

Send email

Manage contacts

Run programs

Query analytics

API design

Next steps

Authentication

Quickstart

​What you can do

Send email

Manage contacts

Run programs

Query analytics

​API design

​Next steps

Authentication

Quickstart

What you can do

API design

Next steps