Back to overview

Importing leads into Leadnodes via webhook

Deliver leads into Leadnodes automatically – via webhook or Zapier integration. Includes a JSON example and API token instructions.

Last updated on July 28, 2025

By default, leads can be delivered to any user via webhook. The webhook URL provided for this purpose is:

https://app.leadnodes.com/hooks/lead/{###-User-API-Token-###}

User API token

The API token is created individually for each user and is used to authenticate the webhook. It can be generated in the user account under the “API Token” menu item.

👉 Further information on creating an API token can be found here:

View the API token guide

Webhook structure

Below you will find an example of the webhook structure. A complete list of all standard parameters for leads can be found here:

View standard lead parameters

Notes:

  • Make sure the user API token is inserted correctly in the URL.

  • Custom fields can be added flexibly, but must be configured in advance.

JSON Payload Example (one dimensional json-object)

{
"lead_type_id" : "1",
"gender" : "m",
"first_name" : "John",
"last_name" : "Doe",
"birth_date" : "1982-10-02",
"street_no" : "Nieder-Kinziger-Str. 27b",
"zip_code" : "64732",
"city" : "Frankfurt",
"phone" : "+49465465466",
"email" : "email@lead.com",
"ip" : "192.186.105.13",
"uuid" : "ID1234678XYZ",
"campaignid" : "12345",
"creative" : "ad name",
"device" : "m",
"keyword" : "keyword",
"matchtype" : "e",
"placement" : "google.com",
"newsletter_optin" : "0"

// custem date examples
"custom_data_field1": "Value A"
"custom_data_field2": "Value B"
"custom_data_field3": "Value B"
}

Zapier integration (no-code automation)

As an alternative to the classic webhook solution, you can also deliver leads into Leadnodes easily via Zapier – without any programming knowledge.

Simply use the following link to get access to our Zapier integration:

👉 Open the Leadnodes Zapier integration

With just a few clicks, you can create individual automations and connect your preferred tools directly to Leadnodes.