BouncerBouncer Docs

Developer Settings

Create API keys and manage integrations


Access Developer Settings to create API keys for external integrations like n8n, Zapier, or your own applications.

Go to Developer in your dashboard sidebar, or visit app.bouncer.my/dashboard/developer.

Create an API key

  1. Click Create API Key
  2. Enter a name (e.g., "n8n Integration")
  3. Choose an environment:
    • Live - Production access for customer-facing integrations
    • Test - Sandbox for development and testing
  4. Select permissions for what the key can access
  5. Click Create

Copy your API key immediately - it won't be shown again.

Permissions

Each API key has specific permissions that control what it can do:

PermissionWhat it allows
message:sendSend messages through WhatsApp
instance:readView WhatsApp connection status
conversation:manageManage conversations (assignments, status)
contact:readRead contact information
contact:writeCreate and update contacts

Select only the permissions your integration needs.

Anti-ban throttling

Enable message throttling to avoid WhatsApp's spam detection when sending high volumes:

  • Off - No throttling (default)
  • Fixed Delay - Constant delay between messages
  • Random Delay - Random delay within a range (recommended)
  • Smart - Random delay + batch cooldowns for high volume

Recommended settings for most use cases:

  • Min delay: 3 seconds
  • Max delay: 8 seconds
  • Max queue: 20 messages

Using your API key

Include your API key in the Authorization header:

curl -X POST https://api.bouncer.my/api/v1/messages/send \
  -H "Authorization: Bearer bnc_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"instanceId": "...", "to": "...", "message": "..."}'

Monitoring

The Developer Settings page also shows:

  • Usage Analytics - Request counts, error rates, top endpoints
  • Activity Log - Recent webhook deliveries and responses
  • Integrations - Configure alerts for instance disconnects

API reference

For complete API documentation including all endpoints, request/response formats, and examples:

View API Documentation