Quickstart

This guide walks through the minimum steps to go from zero to a sent email: create a contact, connect a sender, and send a message through the unified send door.

Prerequisites

You need an API key. If you don’t have one, create one in Settings → API keys.

Step 1 — Create a contact

curl -X POST https://api.norbelys.com/v1/contacts \
  -H "Authorization: Bearer ak_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "givenName": "Alex",
    "familyName": "Rivera"
  }'

The response includes the new contact’s id:

{
  "id": "cnt_abc123",
  "email": "[email protected]",
  "givenName": "Alex",
  "familyName": "Rivera",
  "createdAt": "2026-01-01T00:00:00Z"
}

Step 2 — Find a sender

List your connected mailboxes to find the id of the one you want to send from:

curl https://api.norbelys.com/v1/senders \
  -H "Authorization: Bearer ak_live_…"

Use the id field from the response (e.g. sndr_xyz789).

Step 3 — Send a message

Pass the contact’s email and sender’s id to the unified send door:

curl -X POST https://api.norbelys.com/v1/messages \
  -H "Authorization: Bearer ak_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sndr_xyz789",
    "to": "[email protected]",
    "subject": "Hey Alex",
    "html": "<p>Hi Alex — reaching out because...</p>",
    "text": "Hi Alex — reaching out because..."
  }'

Always send both html and text. Plain-text fallbacks improve deliverability and are required by some clients.

The response confirms the message is queued:

{
  "id": "msg_def456",
  "status": "queued",
  "createdAt": "2026-01-01T00:00:00Z"
}

Next steps

Programs

Build sequences with steps, A/B variants, and automated enrollment.

Analytics

Query opens, clicks, replies, and deliverability from the event store.

Bulk contacts

Import contacts from CSV or create them in batches.

Domains

Verify your sending domain and monitor DMARC alignment.

Get started

Reference

Prerequisites

Step 1 — Create a contact

Step 2 — Find a sender

Step 3 — Send a message

Next steps

Programs

Analytics

Bulk contacts

Domains

​Prerequisites

​Step 1 — Create a contact

​Step 2 — Find a sender

​Step 3 — Send a message

​Next steps

Programs

Analytics

Bulk contacts

Domains

Prerequisites

Step 1 — Create a contact

Step 2 — Find a sender

Step 3 — Send a message

Next steps