Postman Collection · THEITBULLS Developer Hub

Postman Collection Overview

Our Postman Collection provides pre-configured API requests to help you test and explore THEITBULLS APIs quickly. Each request includes example parameters, headers, and expected responses.

Get started: Download the collection and import it into Postman in seconds.

Download Collection Run in Postman View on GitHub

Collection Contents

The collection includes requests for all THEITBULLS API endpoints:

WhatsApp API

POST /v1/whatsapp/messages

Send a WhatsApp message (text, image, document, audio, video)

GET /v1/whatsapp/messages

Get message history with pagination

POST /v1/whatsapp/templates

Create and manage message templates

Email API

POST /v1/email/send

Send a single email

POST /v1/email/campaigns

Create a new email campaign

GET /v1/email/campaigns

List all campaigns with status

Voice API

POST /v1/voice/calls

Initiate an outbound voice call

GET /v1/voice/calls/{call_id}

Get call status and details

POST /v1/voice/ivr

Create or update IVR configuration

Campaign API

POST /v1/campaigns

Create a multi-channel campaign

GET /v1/campaigns

List all campaigns with analytics

Account & Settings

GET /v1/account

Get account details and usage

POST /v1/account/apikeys

Generate new API keys

Environment Variables

The collection includes a THEITBULLS Environment with pre-configured variables:

{{base_url}} - API base URL (sandbox or production)
{{api_key}} - Your API key
{{phone_number}} - Test phone number
{{campaign_id}} - Campaign ID for testing

          // Environment variables example
          {
          "base_url"
          :
          "https://api.theitbulls.com/v1"
          ,
          "api_key"
          :
          "sk_live_abc123"
          ,
          "phone_number"
          :
          "911234567890"
          }
        

How to Import

Download the collection JSON file
Open Postman
Click Import in the top-left
Select Upload Files and choose the JSON file
Import the environment file as well
Set your API key in the environment variables
Start testing!

Important: Replace the placeholder API key with your own key before making requests.

Example Request

Here's an example of a WhatsApp message request in Postman:

          // Request
          POST {{base_url}}/whatsapp/messages Authorization: Bearer {{api_key}} Content-Type: application/json {
          "to"
          :
          "{{phone_number}}"
          ,
          "type"
          :
          "text"
          ,
          "text"
          : {
          "body"
          :
          "Hello from Postman!"
          } }
          // Response
          {
          "id"
          :
          "msg_abc123"
          ,
          "status"
          :
          "sent"
          ,
          "timestamp"
          :
          "2025-06-20T14:30:00Z"
          }
        

Ready to test the APIs? Download the Postman Collection now.

Download Collection