Wpbox API Reference

curl -H "Authorization: Bearer YOUR_TOKEN" \
     "https://app.wacm.in/api/v1/contacts?page=2&limit=20"

{
  "data": [...],
  "links": {
    "first": "...",
    "last": "...",
    "prev": "...",
    "next": "..."
  },
  "meta": {
    "current_page": 2,
    "last_page": 5,
    "per_page": 20,
    "total": 100
  },
  "status": "success",
  "message": "Contacts retrieved successfully"
}

curl -X GET "https://app.wacm.in/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

https://app.wacm.in/webhook/wpbox/receive/{your_token}

{
  "entry": [{
    "id": "WABA_ID",
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "messages": [{
          "from": "919876543210",
          "id": "wamid.XXX",
          "timestamp": "1234567890",
          "type": "text",
          "text": { "body": "Hello" }
        }],
        "contacts": [{
          "profile": { "name": "John Doe" },
          "wa_id": "919876543210"
        }]
      }
    }]
  }]
}

{
  "entry": [{
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "statuses": [{
          "id": "wamid.XXX",
          "status": "delivered",
          "timestamp": "1234567890",
          "recipient_id": "919876543210"
        }]
      }
    }]
  }]
}

{
  "status": "success",
  "message": "Profile retrieved successfully",
  "data": {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "company_name": "Acme Corp"
  }
}

curl -X POST "https://app.wacm.in/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "phone": "+919876543210",
    "email": "john@example.com",
    "city": "Mumbai",
    "company_name": "Acme Corp"
  }'

{
  "status": "success",
  "message": "Contact created/updated successfully",
  "data": {
    "id": 123,
    "name": "John Doe",
    "phone": "+919876543210",
    "email": "john@example.com",
    "city": "Mumbai",
    "country": "India",
    "company": "Acme Corp",
    "subscribed": true,
    "is_on_whatsapp": true,
    "enabled_ai_bot": true,
    "groups": [
      { "id": 1, "name": "VIP Customers" }
    ],
    "tags": [
      { "id": 1, "name": "Lead", "color": "#10B981" }
    ],
    "custom": {},
    "created_at": "2025-01-15T10:30:00.000000Z",
    "updated_at": "2025-01-15T10:30:00.000000Z"
  }
}

curl -X POST "https://app.wacm.in/api/v1/contacts/bulk-sync" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {"phone": "9876543210", "name": "Jane Doe"},
      {"phone": "+919876543211", "name": "John Doe"}
    ],
    "country_code": "91",
    "group_id": 123
  }'

{
  "status": "success",
  "message": "Contacts synced successfully",
  "data": {
    "synced_count": 2,
    "updated_count": 0,
    "created_count": 2,
    "skipped_limit_count": 0
  }
}

curl -X POST "https://app.wacm.in/api/v1/messages/text" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "message": "Hello! This is a test message from WACM API."
  }'

curl -X POST "https://app.wacm.in/api/v1/messages/template" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "template_name": "order_confirmation",
    "template_language": "en",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "John Doe" },
          { "type": "text", "text": "ORD-12345" }
        ]
      }
    ]
  }'

curl -X POST "https://app.wacm.in/api/v1/messages/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "message": "Please select from the options below:",
    "header": "Main Menu",
    "footer": "Powered by WACM",
    "action": {
      "button": "View Options",
      "sections": [
        {
          "title": "Menu Options",
          "rows": [
            { "id": "opt1", "title": "Check Order Status", "description": "Track your recent order" },
            { "id": "opt2", "title": "Talk to Support", "description": "Connect with an agent" }
          ]
        }
      ]
    }
  }'

curl -X POST "https://app.wacm.in/api/v1/media" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@/path/to/invoice_INV-9821.pdf" \
  -F "type=document"

{
  "status": "success",
  "message": "Media uploaded to Meta successfully",
  "data": {
    "id": "184920491823910",
    "url": "https://app.wacm.in/storage/uploads/companies/1/media/2026/03/invoice_INV-9821.pdf",
    "mime_type": "application/pdf",
    "file_name": "invoice_INV-9821.pdf",
    "file_size": 245100
  }
}

{
  "data": [
    {
      "id": 1,
      "name": "order_confirmation",
      "language": "en",
      "status": "APPROVED",
      "category": "UTILITY",
      "components": [
        {
          "type": "BODY",
          "text": "Hi {{1}}, your order {{2}} has been confirmed!"
        }
      ],
      "created_at": "2025-01-15T10:30:00.000000Z",
      "updated_at": "2025-01-15T10:30:00.000000Z"
    }
  ],
  "status": "success",
  "message": "Templates retrieved successfully"
}

{
  "status": "success",
  "message": "Groups retrieved successfully",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "name": "VIP Customers",
        "contacts_count": 150,
        "created_at": "2025-01-15T10:30:00.000000Z",
        "updated_at": "2025-01-15T10:30:00.000000Z"
      }
    ],
    "total": 1
  }
}

curl -X POST "https://app.wacm.in/api/v1/campaigns/audience-preview" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "audience_type": "group",
    "group_id": 1,
    "template_id": 12,
    "prevent_template_duplicates": true
  }'

{
  "status": "success",
  "message": "Campaign audience preview retrieved successfully",
  "data": {
    "audience_type": "group",
    "eligible_contacts": 142
  }
}

curl -X POST "https://app.wacm.in/api/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Sale 2025",
    "template_id": 1,
    "audience_type": "all",
    "send_now": true,
    "paramvalues": {
      "1": "Summer Sale",
      "2": "50% OFF"
    }
  }'

{
  "phone": "+919876543210",
  "campaign_id": 123
}

{
  "data": [
    {
      "id": 1,
      "fb_message_id": "wamid.HBgM...",
      "contact_id": 123,
      "value": "Hello! How can I help you?",
      "status": 4,
      "is_message_by_contact": 0,
      "message_type": 1,
      "created_at": "2025-01-15T10:30:00.000000Z",
      "updated_at": "2025-01-15T10:30:00.000000Z"
    }
  ],
  "status": "success",
  "message": "Messages retrieved successfully"
}

{
  "message": "The phone number is required.",
  "errors": {
    "phone": ["The phone field is required."]
  }
}