API & Developers

Getting Started with HelpKit API

1 min readMar 19, 2026

HelpKit REST API — Getting Started

The HelpKit API lets you integrate WhatsApp messaging into your own applications, automate workflows, and access all HelpKit data programmatically.

Base URL

https://api.helpkit.in/v1

All endpoints require HTTPS. HTTP requests are rejected.

Authentication

HelpKit uses Bearer token authentication.

Generating an API Key:

1.Go to Settings → API → API Keys → Generate New Key

2.Name the key (e.g., "Production App", "Zapier Integration")

3.Copy the key immediately — it's shown only once

Using the API Key:

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.helpkit.in/v1/contacts

First API Call — List Contacts

bash

curl -X GET \
  https://api.helpkit.in/v1/contacts \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Response:

json

{
  "data": [
    {
      "id": "c_123abc",
      "name": "Priya Sharma",
      "phone": "+919876543210",
      "tags": ["VIP"],
      "created_at": "2026-02-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 342
  }
}

Core API Endpoints

| Resource | Methods | |----------|---------| | /contacts | GET, POST, PUT, DELETE | | /conversations | GET, POST | | /messages | GET, POST | | /campaigns | GET, POST | | /templates | GET | | /webhooks | GET, POST, DELETE | | /analytics/conversations | GET |

SDKs

Official SDKs available:

•Node.js: npm install helpkit-sdk

•Python: pip install helpkit

•PHP: composer require helpkit/sdk

Error Codes

| Code | Meaning | |------|---------| | 200 | Success | | 201 | Created | | 400 | Bad request — check your parameters | | 401 | Unauthorized — invalid API key | | 404 | Resource not found | | 429 | Rate limited — slow down requests | | 500 | Server error — contact support |