Troubleshooting

Common issues and solutions when working with the Approved Contact Texting API.

Authentication Errors

401 Unauthorized

Problem: Your API requests are being rejected with a 401 status code.

Solutions:

• Verify your email and password are correct
• Ensure credentials are Base64 encoded properly
• Check the Authorization header format: Basic <credentials>
• Confirm you're using HTTPS, not HTTP

Message Delivery Issues

Messages Not Sending

Problem: Messages are queued but not being delivered.

Solutions:

• Verify the phone number is provisioned
• Check that the recipient number is in E.164 format
• Ensure the message body is not empty
• Review message logs for error details

422 Validation Error

Problem: Request is rejected with validation errors.

Solutions:

• Check the fieldErrors in the response for specific issues
• Verify all required fields are included
• Ensure field values meet format requirements

Rate Limiting

429 Too Many Requests

Problem: Requests are being throttled.

Solutions:

• Implement exponential backoff retry logic
• Respect the Retry-After header
• Use async messaging for high-volume sends
• Contact support for increased rate limits

Webhook Issues

Webhooks Not Receiving Data

Problem: Your webhook endpoint isn't receiving notifications.

Solutions:

• Verify your webhook URL is publicly accessible
• Ensure your endpoint returns 200-299 status codes
• Check webhook configuration in tenant settings
• Verify signature validation is working correctly

Getting Help

Additional Resources

• API Health Check - Check API status
• API Reference - Complete endpoint documentation
• Best Practices - Reliability and security guidelines