/bff/lead/create

Creates a new lead/inquiry. Optionally creates or links an existing customer by email. The lead starts in "new" status.

LeadpostBffLeadCreate

Parameters

11 body

11 total

Body · 11

subjectstringRequired

Lead subject/title.

Length: 1–∞

descriptionstring

Detailed description of the inquiry.

sourcestring | string | string | string | string

How the lead was acquired.

customerEmailstring

Customer email — creates or finds existing contact.

customerPhonestring

Customer phone.

customerFirstNamestring

Customer first name.

customerLastNamestring

Customer last name.

assignedMemberIdnumber

Organisation member ID to assign.

estimatedValuenumber

Estimated deal value.

followUpDatestring

Next follow-up date (ISO timestamp).

internalNotestring

Internal note for the sales team.

Request

POST /bff/lead/create

post

curl -X POST "https://api.bizkithub.com/bff/lead/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "subject": "example_subject",
  "description": "example_description",
  "customerEmail": "example_customerEmail",
  "customerPhone": "example_customerPhone",
  "customerFirstName": "example_customerFirstName",
  "customerLastName": "example_customerLastName",
  "assignedMemberId": 0,
  "estimatedValue": 0,
  "followUpDate": "2026-03-01",
  "internalNote": "example_internalNote"
}'

Response

JSON payload

{
  "success": false,
  "id": 0
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key