Docs
Get started

Create an API key

Authenticate your requests.

API keys authenticate every request your app makes to Postwave.

Create a key

  1. Open API keys in the dashboard.
  2. Click + Create API key.
  3. Give it a name (e.g. Production), then pick the permission:
    • Full access: can use every endpoint.
    • Sending access: can only send email. Optionally lock it to one domain.
  4. Click Add and copy the key. It starts with pw_ and is only shown once.

Use the key

Send it in the Authorization header:

Authorization: Bearer pw_xxxxxxxxx

The SDKs read it from the constructor or from an environment variable.

Keep keys safe

  • Store keys in environment variables or a secrets manager, never in code or a public repo.
  • Use a sending access key in apps that only send email.
  • If a key leaks, revoke it in API keys and create a new one. It stops working immediately.
Was this page helpful?Send feedback