Blog
Notes from the
honest side of email
Deliverability, honest analytics and outreach craft — written in plain language, with no growth-hack snake oil.
Earlier articles
103 articles
Developer7 min
Automating cold-email ops checks with the Norbelys CLI in CI
A working GitHub Actions example: install the norbelys CLI, authenticate with $NORBELYS_API_KEY, and run a scripted campaign-config check on every push or schedule.
Developer7 min
Managing multiple Norbelys orgs from one terminal with the CLI
How the norbelys CLI's one-profile-per-org config file works, and the safe patterns for switching between client workspaces without hitting the wrong org.
DeveloperAnalysis7 min
CLI vs. dashboard: when scripting cold-email ops actually beats clicking
An honest, non-absolutist take on when the norbelys CLI is the right tool for an operational task, and when the dashboard genuinely serves you better.
Developer7 min
norbelys login: API key vs. browser OAuth, and where your credentials live
The CLI's two auth modes — org-scoped API keys and PKCE browser OAuth — when to use which, and why config.json's 0600 file permission actually matters.
Developer7 min
Installing the Norbelys CLI and running your first command
Two ways to install the norbelys CLI, how it turns the REST API into commands automatically, and a full walkthrough from install to your first real call.
Developer7 min
Event webhooks are on the way: what to use instead, today
Norbelys outbound event webhooks aren't live yet. An honest look at that, plus a guide to cursor-pagination polling and MCP for near-real-time needs today.
Developer7 min
The norbelys Python SDK quickstart: pip install to your first call
Install the official Python SDK from PyPI, authenticate with an API key, and make your first typed call against the Norbelys API — a complete quickstart.
DeveloperAnalysis6 min
Node, Python, Go, or Ruby: which Norbelys SDK should you use?
A practical decision guide to the four official Norbelys SDKs: which fits an edge Worker, a data script, a high-throughput backend, or a Rails app.
DeveloperAnalysis6 min
DELETE /v1/people/:id vs. people:erase: two buttons that look similar and aren't
DELETE archives a contact and is reversible. people:erase is a separate, audited GDPR flow that destroys PII forever. Conflating the two is a real compliance bug.
Developer6 min
Handling Norbelys API rate limits: backoff that doesn't make things worse
A tight retry loop against a 429 doesn't just fail — it adds load to a shared multi-tenant database exactly when it's already under pressure. How to back off correctly.
Developer8 min
The @norbelys/sdk quickstart: from npm install to your first API call
Install the official Node/TypeScript SDK, authenticate with an API key, and make your first typed call against the Norbelys API — a complete quickstart.
Developer6 min
Cursor pagination explained: why the Norbelys API doesn't use page numbers
Page numbers silently skip or double-serve rows when data changes mid-list. Why the Norbelys API paginates on (createdAt, id) instead, with a working example.