​

End-to-end ingest example

​

Goal

1. Receive a synthetic lead through a channel source webhook
2. Publish a mapping
3. Switch the source to live
4. Deliver once
5. Confirm the resulting transaction

​

1. Create the source path in Airlead

1. Create or open a channel.
2. Create an API source.
3. Open Technik.
4. Copy the Test-Webhook URL.
5. Enable a source secret for anything beyond local testing.

POST /api/webhooks/channels/{channelId}/sources/{sourceId}/leads

​

2. Send a sample payload

{
  "lead_id": "demo-1001",
  "contact": {
    "first_name": "Alex",
    "last_name": "Example",
    "email": "alex@example.com",
    "phone": "+491701234567"
  },
  "product": "heat-pump",
  "answers": {
    "current_heating": "oil"
  },
  "consent": "granted"
}

​

3. Publish the mapping

1. Map contact.first_name → person first name
2. Map contact.last_name → person last name
3. Map contact.email / phone → person contact fields
4. Map product → product
5. Map answers.* → interest field values
6. Map lead_id → external ID
7. Publish the mapping

​

4. Validate the records

• one person was created
• one interest exists for the expected product
• field values are correct
• the external ID is stored
• replaying the same lead_id returns an idempotent replay

​

5. Go live carefully

1. Switch the source from test to live.
2. Use the live webhook URL for production systems.
3. Keep triggerAutoDelivery false, or Delivery 1.0 disabled, until a manual delivery succeeds.
4. Send one more synthetic live lead.

​

6. Deliver and create a transaction

1. Confirm the interest is routing-ready.
2. Confirm at least one buyer is eligible.
3. Deliver manually once.
4. Verify the buyer received the payload.
5. Open the transaction and store its transactionId.

{
  "event": "lead.delivered",
  "transactionId": "txn_...",
  "leadRequestId": "...",
  "leadId": "..."
}

​

7. Report the commercial outcome

1. confirmation or rejection
2. optional payout pending
3. payout
4. or cancellation / Storno with a required reason

​

Success checklist

• Sample received in Technik
• Mapping published
• Person and interest verified
• External ID replay is idempotent
• Live URL and secret configured
• Manual delivery created one transaction
• Buyer can confirm or cancel with the transaction ID

​

If something fails