Create and manage API keys

Generate API keys so you can send messages, manage contacts, and trigger campaigns from your own code.

Last updated 2026-05-31

API keys let external systems talk to WaSMS programmatically. Each key has defined scopes.

1. Create a key

  1. Go to Dashboard → API Keys.
  2. Click + New API key.
  3. Name it.
  4. Pick scopes.
  5. Click Create. Full key is shown once — copy it now.

Available scopes

  • messages:send — send messages
  • messages:read — read message history
  • contacts:read, contacts:write
  • otp:send, otp:verify
  • campaigns:read, campaigns:write
  • webhooks:manage

2. Use the key

curl https://wasms.net/api/public/v1/messages   -H "Authorization: Bearer wasms_xxxxxxxxxxxxxxxx"   -d '{"to":"+9230....","text":"Hello"}'

3. Copy / Revoke

  • Copy — reveal the full key once authenticated.
  • Revoke — immediately disables.

Security

  • Never commit API keys to Git.
  • Rotate when team members leave.
  • Use scopes — do not give blanket access.
  • Watch audit log on the API Keys page.

More in API & Webhooks