Get started
Create an API key
Authenticate your requests.
API keys authenticate every request your app makes to Postwave.
Create a key
- Open API keys in the dashboard.
- Click + Create API key.
- 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.
- 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_xxxxxxxxxThe 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