INTEGRATIONS ~5 Min Setup

How to obtain your WaSender API Key & Instance ID.

WaBulk Hub acts as a powerful frontend automation layer that utilizes the core WaSender API architecture to dispatch your messages securely. By linking your WaSender API Key and Instance ID to WaBulk Hub, you unlock our advanced CSV mapping, intelligent anti-ban scheduling, and real-time analytics dashboard.

What you'll need before starting

  • An active subscription/account with a self-hosted or SaaS WaSender panel.
  • The base URL to your WaSender Dashboard (e.g., https://wa.yourdomain.com).
  • Your mobile phone with the official WhatsApp app installed and an active internet connection.
1

Access your WaSender Panel

Navigate to the web address provided by your WaSender host. Enter your registered email address and password to log into the main dashboard. Ensure you are logging in with an account that has Device Management permissions.

https://your-wasender-panel.com

Welcome Back

Sign in to your WaSender account

Login
2

Create Session & Scan QR

WaSender uses WhatsApp's Multi-Device architecture. You must create an "Instance" (or Device) in your panel and link it by scanning a QR code with your phone.

  1. On the left sidebar of your WaSender panel, click on WhatsApp, Devices, or Instances.
  2. Click the Add Account button.
  3. A QR code will generate on your computer screen.
  4. Open WhatsApp on your phone, go to Settings → Linked Devices → Link a Device.
  5. Scan the QR code displayed on your desktop.

Your Phone

Linked

Panel QR

Keep your phone connected to the internet. While Multi-Device allows independent sending, initial syncing and long-term stability require your primary device to check in with WhatsApp servers periodically.

3

Copy API Key & Instance ID

Now that your number is connected, you need two crucial pieces of information to allow WaBulk Hub to communicate with your specific number: your Global API Key, and the specific Instance ID (or Device ID).

  • Look at the left sidebar menu of your WaSender panel and click on Developer or API.
  • 1. API Key: Locate the master Access Token or API Key. Copy it.
  • 2. Instance ID: Find the Instance ID (sometimes called Device ID) corresponding to the phone number you just linked. Copy this as well.

API Credentials

sk_live_a9f87b2...[Hidden]...3j29x
642B9A1F
Connected Device (+1 234 567 8900)

Do not share these keys with anyone outside of your WaBulk Hub dashboard.

4

Connect to WaBulk Hub Engine

You have successfully acquired your credentials. The final step is to securely inject them into your WaBulk Hub workspace so the automation engine can take over sending your campaigns.

  1. Log in to your WaBulk Hub Dashboard.
  2. Navigate to Settings / API.
  3. Locate the WaSender Integration section.
  4. Paste your API Key and Instance ID into their respective fields. Also, enter your WaSender Domain URL.
  5. Click Save & Verify Changes.
Log in to WaBulk Hub

Verify via cURL (Optional)

Want to be 100% sure your keys are working before adding them to WaBulk Hub? You can run a quick test using your computer's terminal (or Postman). Replace the placeholder values with your actual data.

bash
curl -X POST "https://[YOUR_WASENDER_DOMAIN]/api/send" \
-H "Content-Type: application/json" \
-d '{
    "number": "1234567890", 
    "type": "text", 
    "message": "Hello from API!", 
    "instance_id": "[YOUR_INSTANCE_ID]", 
    "access_token": "[YOUR_API_KEY]"
}'

If successful, you will receive a {"status":"success"} response and the message will appear on your phone.

Troubleshooting Common Errors

Device Disconnected / Session Offline

If your WaSender panel shows your WhatsApp device is disconnected, WaBulk Hub will fail to send messages (resulting in Pending statuses). Fix: Go back to Step 2, delete the disconnected device instance, and scan a fresh QR code.

Invalid API Key / Unauthorized (401)

Ensure there are no trailing spaces or missing characters in your API Key or Domain URL. Do not include a trailing slash (/) at the end of your Domain URL in the settings.

Rate Limiting / Messages Stuck

If sending bulk campaigns too quickly, WhatsApp or your hosting provider may rate-limit the requests. WaBulk Hub has built-in smart delays, but ensure your WaSender host server has adequate resources and no strict firewalls blocking inbound WaBulk Hub API requests.