Skip to content

Lead submitted via a public form

POST

Triggered when a visitor submits a form at POST /public/forms/:formSlug/submit. Delivered to the webhook URL configured on the form. Signed with X-KL-Signature (HMAC-SHA256 of the raw body using the form webhook secret).

Media type application/json
object
event
required

Event type

string
Allowed values: lead.submitted
leadId
required

Created lead identifier

string format: uuid
formSlug
required

Slug of the submitted form

string
brandId
required

Parent brand

string format: uuid
locationId
required

Location scope if the form is location-scoped

string | null format: uuid
fields
required

Submitted field values keyed by field name

object
key
additional properties
createdAt
required

Submission timestamp (ISO 8601)

string format: date-time

Webhook received and acknowledged