---
title: "API Reference"
description: "Reference documentation for Bulkit endpoints, request schemas, responses, and error behavior."
---

# API Reference

The API reference documents Bulkit’s production endpoints in an implementation-focused format.

Use this section when you need:

- endpoint URLs and methods
- request payloads
- response examples
- validation rules
- common error messages

## Endpoint groups

### Account

- [Get Account Balance](/account/get-account-balance)

### SMS

- [How to Send SMS](/sms/overview)
- [Send SMS Using Header Authorization](/sms/send-sms-using-header-authorization)
- [Send SMS Using URL Params](/sms/send-sms-using-url-params)
- [Send a Single SMS](/sms/send-a-single-sms)
- [Send Customized SMS](/sms/send-customized-sms)
- [How to Setup SMS Webhook](/sms/how-to-setup-sms-webhook)
- [Shortcode Inbox SMS Webhook](/sms/shortcode-inbox-sms-webhook)
- [Keyword Inbox SMS Webhook](/sms/keyword-inbox-sms-webhook)
- [How to Get Delivery Reports](/sms/how-to-get-delivery-reports)
- [SMS API Error Messages](/sms/error-messages)

### Contacts

- [Contacts Overview](/contacts/overview)
- [Fetch Groups](/contacts/fetch-groups)
- [Create Contact](/contacts/create-contact)
- [Create Multiple Contacts](/contacts/create-multiple-contacts)
- [Delete Contact](/contacts/delete-contact)

### WhatsApp

- [WhatsApp API Overview](/whatsapp/overview)
- [Send WhatsApp Message](/whatsapp/send-message)
- [Send Media & Attachments](/whatsapp/send-media)
- [Send Bulk WhatsApp Broadcast](/whatsapp/send-bulk)
- [Inbox & Message History](/whatsapp/inbox-and-messages)
- [Connection Status](/whatsapp/connection-status)

### Webhooks

- [Webhooks Overview](/webhooks/overview)
- [Delivery Reports (DLR)](/webhooks/delivery-reports)
- [Inbound Messages](/webhooks/inbound-messages)

## Conventions

Bulkit API follows these conventions:

- JSON request and response bodies for `POST` endpoints
- API key authentication for all endpoints
- stable validation messages for common errors
- timezone-aware scheduling where scheduling is supported

## Common response format

Successful responses typically look like this:

```json
{
  "status": "success",
  "message": "Request processed successfully",
  "data": {}
}
```

Error responses typically look like this:

```json
{
  "status": "error",
  "message": "Invalid credentials"
}
```