Follow these steps to send your first API request.

​
Step 1 — Get your API token from the app

Log in to app.billclap.com, open Settings → API Integration, and generate your API token.
The token can only be generated once per business from the BillClap application. Copy and store it securely—it is valid for 365 days.
See Introduction for the full setup flow.

​
Step 2 — Create an invoice

curl -X POST https://api.billclap.com/api/web/invoice/create-invoice \
  -H "Content-Type: application/json" \
  -H "x-api-token: YOUR_API_TOKEN" \
  -d '{
    "type": "SALESINVOICE",
    "issue_date": "2026-07-01",
    "due_date": "2026-07-15",
    "receive_amount": 1180,
    "party_detail": {
      "party_name": "Acme Traders",
      "mobile_no": "9876543210",
      "gst_no": "29ABCDE1234F1Z5",
      "address": "123 MG Road",
      "city": "Bengaluru",
      "state": "Karnataka",
      "country": "India",
      "pin_code": "560001"
    },
    "product_details": [
      {
        "product_name": "Consulting Service",
        "product_sell_price": 1000,
        "product_sell_price_tax_type": "With Tax",
        "product_gst": 18,
        "product_hsn": "998314",
        "product_quantity": 1
      }
    ]
  }'

​
Step 3 — Handle the response

{
  "result": {
    "status": true,
    "message": "Invoice created successfully",
    "invoice_id": 12345,
    "link": "https://app.billclap.com/preview/12345/abc123",
    "code": 200
  }
}
The link field is a shareable preview URL for the created invoice.

​
Next steps

Authentication

Learn how API tokens work and how to authenticate requests.

Create Invoice API

Full request/response reference for invoice creation.