Skip to content

JengaStack Docs

API Reference

JengaFlow REST API Reference¶

The JengaFlow API enables programmatic workflow execution, status monitoring, and outbound WhatsApp messaging.

Base URL: https://jengaflow-api.jengastack.app
Authentication: Bearer Token via Authorization: Bearer <API_KEY>

1. Health Check¶

Request¶

curl -s https://jengaflow-api.jengastack.app/v1/auth/health/

Response¶

{
  "status": "healthy",
  "version": "1.0.0",
  "services": {
    "database": "ok",
    "redis": "ok",
    "n8n": "ok"
  }
}

2. Trigger Workflow¶

Executes a specified workflow programmatically with a JSON payload.

Request¶

curl -X POST https://jengaflow-api.jengastack.app/v1/workflows/trigger/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_mpesa_reconcile",
    "payload": {
      "transaction_id": "LHG782910J",
      "amount": 4999.00,
      "phone": "254712345678"
    }
  }'

Response (`200 OK`)¶

{
  "execution_id": "exec_847193",
  "status": "QUEUED",
  "created_at": "2026-08-20T12:28:00Z"
}

3. Send WhatsApp Template Message¶

Sends a pre-approved WhatsApp Business template message to a recipient.

Request¶

curl -X POST https://jengaflow-api.jengastack.app/v1/notifications/whatsapp/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "254712345678",
    "template": "invoice_receipt",
    "parameters": {
      "customer_name": "Jane Wanjiku",
      "invoice_number": "INV/2026/00142",
      "amount": "KSh 4,999",
      "pdf_url": "https://jengastack.app/media/invoices/INV-00142.pdf"
    }
  }'

Response (`202 Accepted`)¶

{
  "message_id": "wamid.HBgLMjU0NzEyMzQ1Njc4FQIAERgSRjQ...",
  "status": "SENT"
}