nudgel.ai

For Developers

An API that respects your time.

REST API with OpenAPI 3.1 spec, typed SDKs in eight languages. Contacts, messages, workflows, deals — everything in the dashboard is one API call away.

Read the docs Quickstart

SDKs

First-class support in your language.

Every SDK is generated from the OpenAPI spec and published to the official package registry. Types, autocomplete, and inline docs come free.

Node.js
1import { Nudgel } from "@nudgel/sdk";23const client = new Nudgel(process.env.NUDGEL_KEY!);45await client.contacts.upsert({6  email: "ada@nudgel.ai",7  name: "Ada Wanjiku",8  tags: ["premium", "KE"],9});1011const { id } = await client.messages.send({12  channel: "sms",13  to: "+254722000000",14  template: "order-confirmation",15  variables: { name: "Ada", order_id: "AC-1042" },16});

API resources

Four endpoints, infinite possibilities.

Contacts API

Upsert, search, import, and segment contacts programmatically.

/v1/contacts

Messages API

Send messages, track delivery status, and get receipts.

/v1/messages

Events API

Fire behavioral events, build timelines, and trigger workflows.

/v1/events

Webhooks

Subscribe to events with signed payloads and automatic retries.

/v1/outbound-webhooks

How the API works

Request in, result out.

Authenticate with a single API key. Every endpoint follows REST conventions. Responses are predictable JSON — no surprises, no magic.

POST/v1/contacts
POST/v1/messages
GET/v1/contacts/:id

Built right

The details that developers notice.

We sweat the small stuff so integrations are predictable, safe, and easy to debug.

OpenAPI 3.1 specification

Full spec at /v1/openapi.json. Generate clients, validate requests, and build integrations with confidence.

Idempotent by default

Pass an idempotency_key on any write operation. Retry safely without duplicate side effects.

Signed webhooks

Every webhook delivery includes an HMAC-SHA256 signature. Verify authenticity before processing.

Rate limiting

1,000 requests per minute per API key by default. Configurable limits on Enterprise plans.

Custom objects

Define your own schemas and CRUD them via API. Attach custom data to contacts, deals, and workflows.

Ship your first integration tonight.

Five minutes from install to your first API call. The quickstart walks you through authentication, sending a message, and receiving a webhook.

Read the quickstart API reference

No credit card · Pay in KES, NGN, UGX or USD · Cancel anytime