Resources

Leads

The Lead endpoint lets ad forms and external enquiry channels create CRM pipeline records without manual entry.

Create a lead

POST/api/v1/leads

Creates a lead in your org. Requires an API key with write:leads or write:* scope.

terminal

curl https://www.zengbook.com/api/v1/leads \
  -H "Authorization: Bearer zb_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alex Tan",
    "companyName": "Tan Renovations Pte Ltd",
    "email": "[email protected]",
    "phone": "+65 9123 4567",
    "source": "GOOGLE_ADS",
    "expectedValue": 18000,
    "nextFollowUpAt": "2026-05-21T02:00:00.000Z",
    "adCampaign": "May renovation leads",
    "adSourceId": "google-form-123"
  }'

201 Created

{
  "id": "lead_01HX...",
  "name": "Alex Tan",
  "companyName": "Tan Renovations Pte Ltd",
  "email": "[email protected]",
  "phone": "+65 9123 4567",
  "source": "GOOGLE_ADS",
  "stage": "NEW",
  "adProvider": null,
  "adCampaign": "May renovation leads",
  "adSourceId": "google-form-123",
  "createdAt": "2026-05-20T02:00:00.000Z"
}

Source values

Valid source values are GOOGLE_ADS, FACEBOOK_ADS, REFERRAL, WEBSITE, WHATSAPP, WALK_IN, REPEAT_CLIENT, PARTNER, and OTHER.