Skip to main content

Step 1: Create an API key

Sign in to the Pulsewave dashboard and create a key from Settings → API Keys, or create one via the API itself once you have a starter key:
Start with a test key (pw_test_...) — it behaves identically to a live key but only delivers to addresses you’ve verified as test recipients, and never bills your account. See Authentication.

Step 2: Install an SDK

Step 3: Send a message

You’ll get back a message in queued status:

Step 4: Track delivery

Poll Retrieve a message with the returned id:
Or, better, set up a webhook endpoint once and get delivery, bounce, open, and click events pushed to you automatically — see Webhooks.

Next steps

Use a domain you own

Verify a sending domain for better email deliverability.

Build with templates

Move message content out of your codebase and into reusable templates.

Add SMS and push

Send to other channels with the same endpoint.

Go live

Switch from a test key to a live key when you’re ready.