Back to Communications Hub

8x8 SMS Diagnostics

Test and diagnose 8x8 SMS API connectivity issues

Configuration Status

Checking configuration...

API Endpoint Tests

Test different 8x8 API endpoints to find which one works with your account.

Available Endpoints to Test:

Send Test SMS

Send a test message to verify SMS delivery.

Diagnostic Log

[Ready] Diagnostic tool initialized

Troubleshooting Guide

Common Issues:

401 Unauthorized
API key is invalid or expired. Generate a new key in 8x8 Admin Console.
400 Bad Request
Phone number format issue. Ensure country code is included (+1 for US).
403 Forbidden
API access not enabled. Enable SMS API in 8x8 Admin Console > Integration.
Network Error
Firewall blocking. Whitelist: api.8x8.com, sms.8x8.com, api.wavecell.com

Required 8x8 Setup:

  1. Log into 8x8 Admin Console
  2. Go to Integration or API section
  3. Enable SMS API access for your account
  4. Generate an API key (Bearer token)
  5. Note your subaccount ID and sender number
  6. Add the API key to Netlify environment variables as EIGHT_BY_EIGHT_API_KEY

Webhook Setup for Delivery Receipts:

To receive delivery status updates (Delivered, Failed, etc.), configure a webhook in 8x8:

  1. In 8x8 Admin Console, go to Integration > Webhooks
  2. Click Add Webhook
  3. Set the Webhook URL to:
Webhook URL (click to copy)
https://wellbe-comms-api-375785209979.us-central1.run.app/api/comms/sms/webhook
  1. Select events: SMS Delivery Report, Message Status
  2. Set Method to POST
  3. Save and test the webhook