Getting Started · THEITBULLS Developer Documentation

Welcome to THEITBULLS

THEITBULLS provides a suite of enterprise-grade communication APIs including WhatsApp Cloud API, Email Automation, Voice API, and more. This guide will help you get started with your first integration in minutes.

Estimated time: 5-10 minutes

Prerequisites

A THEITBULLS account (free trial available)
API keys from your dashboard
Basic understanding of REST APIs
cURL or your preferred HTTP client

Step 1: Get Your API Keys

1 Log in to your THEITBULLS dashboard

2 Navigate to Settings → API Keys

3 Generate a new API key. You'll receive both a Test Key and a Live Key

4 Copy your API key and store it securely

Security tip: Never commit your API keys to version control. Use environment variables or a secrets manager.

Step 2: Make Your First API Call

Let's send your first WhatsApp message using the THEITBULLS API.

Request

          # Send a WhatsApp message
          curl
          -X POST https://api.theitbulls.com/v1/whatsapp/messages \ -H
          "Authorization: Bearer YOUR_API_KEY"
          \ -H
          "Content-Type: application/json"
          \ -d
          '{ "to": "911234567890", "type": "text", "text": { "body": "Hello from THEITBULLS! 🚀" } }'
        

Response

          {
          "id"
          :
          "msg_abc123"
          ,
          "status"
          :
          "sent"
          ,
          "timestamp"
          :
          "2025-06-20T14:30:00Z"
          }
        

Success! Your first message has been sent. Check your WhatsApp to see it delivered.

Step 3: Set Up Webhooks

Webhooks allow you to receive real-time events like incoming messages, delivery status, and more.

Go to Settings → Webhooks in your dashboard
Enter your webhook URL (e.g., https://your-app.com/webhook )
Select the events you want to receive
Save your configuration and verify the webhook

          # Example webhook payload
          {
          "event"
          :
          "message.inbound"
          ,
          "from"
          :
          "911234567890"
          ,
          "text"
          :
          "Hello from a customer!"
          ,
          "timestamp"
          :
          "2025-06-20T14:35:00Z"
          }
        

Step 4: Explore SDKs

Accelerate your development with our official SDKs for popular languages:

Java SDK: Maven: com.theitbulls:api-client:2.1.0
Node.js SDK: npm install @theitbulls/api
PHP SDK: composer require theitbulls/api
Python SDK: pip install theitbulls-api

What's Next?

Explore the WhatsApp API documentation
Learn about authentication best practices
Set up advanced webhook configurations
Check out our full API reference

Need help? Our team is here to assist you.

Get Support