Ingest payload schema

Native schema (when no published mapping is applied).

Lead object

Field	Type	Required	Notes
`externalId`	string	no	1–128 chars; idempotency key
`firstName`	string	yes
`lastName`	string	yes
`email`	string	no	email or empty string
`phone`	string	no
`street`	string	no
`houseNumber`	string	no
`postalCode`	string	no
`city`	string	no
`country`	string	no
`consentStatus`	string	no
`legalBasis`	string	no
`consentCapturedAt`	string	no
`consentTextVersion`	string	no
`capturedByExternalId`	string	no
`capturedByName`	string	no
`capturedByTeam`	string	no
`capturedAt`	string	no
`captureMethod`	string	no
`capture`	object	no	nested capture metadata
`request` / `requests`	object / array	no	interest payload(s)
`productSlug` / `productId`	string	no
`routingReady`	boolean	no
`triggerAutoDelivery`	boolean	no	Requests Delivery 1.0 evaluation when `true`; effective channel and buyer settings still apply
`fieldValues`	object	no	string map

Nested `capture`

capturedByExternalId, capturedByName, capturedByTeam, capturedAt, captureMethod, metadata.

Nested `request`

productSlug, productId, routingReady, triggerAutoDelivery, fieldValues.

Accepted top-level shapes

1. Flat lead

{ "firstName": "Alex", "lastName": "Example", "productSlug": "heat-pump" }

2. Person + interests (channel)

{
  "externalId": "ext-1",
  "person": {
    "firstName": "Alex",
    "lastName": "Example",
    "email": "alex@example.com"
  },
  "interests": [{ "productSlug": "heat-pump", "fieldValues": { "city_zone": "north" } }],
  "triggerAutoDelivery": false
}

Use false while validating a new source. Enable the flag only after a manual test delivery succeeds and Delivery 1.0 is configured for the channel.

3. Batch

{
  "leads": [
    { "firstName": "A", "lastName": "One" },
    { "firstName": "B", "lastName": "Two" }
  ]
}

Constraints: leads min 1, max 100.

Basics

Lead ingest

Delivery contract

Transaction lifecycle

Service status

Ingest payload schema

Ingest payload schema

Lead object

Nested `capture`

Nested `request`

Accepted top-level shapes

1. Flat lead

2. Person + interests (channel)

3. Batch

​Ingest payload schema

​Lead object

​Nested capture

​Nested request

​Accepted top-level shapes

​1. Flat lead

​2. Person + interests (channel)

​3. Batch

Ingest payload schema

Lead object

Nested `capture`

Nested `request`

Accepted top-level shapes

1. Flat lead

2. Person + interests (channel)

3. Batch