Quickstart

Send your first email with an API key, via cURL or fetch.

Before you start

Create an API key

In the dashboard, under API Keys. The plaintext token is shown only once, at creation.

Verify a domain

Add a domain and publish its SPF, DKIM and DMARC records.

Send

In test mode or in production.

Install the SDK

Recommended: use the official SDK (TypeScript or Python). You can always call the API over plain HTTP instead.

npm install sending-sdk

Send an email

import { Sending } from "sending-sdk";
 
const sending = new Sending({ apiKey: process.env.SENDING_API_KEY! });
 
await sending.emails.send({
  from: "Acme <[email protected]>",
  to: "[email protected]",
  subject: "Welcome",
  html: "<h1>Ready</h1>",
  idempotencyKey: "welcome-sara-001",
});

The SDK defaults to https://sending.dev/api/v1; the apiKey goes in the Authorization: Bearer header.

Always pass idempotencyKey in the body (required, min 8 characters) so a retry cannot send twice. There is no Idempotency-Key header.

The from field also accepts a display name: Name <[email protected]>. Same format for replyTo.

Introduction

Official SDKs