Submit lead
curl --request POST \
--url https://{tenant}.techea.eu/api/v1/lead \
--header 'Content-Type: application/json' \
--header 'apikey: <api-key>' \
--data '
{
"product_id": "36068625-4707-4ef8-a419-2aad1483db49",
"publisher_id": "b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b",
"customer": {
"external_id": "pub-12345-abc",
"personal_data": {
"first_name": "John",
"last_name": "Smith",
"second_surname": "Johnson",
"birthday": "1988-05-10",
"identification_number": "12345678A",
"nacionality": "ES",
"gender": "male"
},
"contact": {
"email": {
"address": "john.smith@email.com",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
},
"phone": {
"area_code": "+34",
"number": "600111222",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
}
},
"address": {
"street": "Calle Mayor",
"house": "1",
"city": "Madrid",
"region": "Madrid",
"postal_code": "28001",
"country": "ES"
},
"profile": {
"occupation": "self_employed",
"monthly_income": 2500,
"monthly_expenses": 1500,
"marital_status": "married",
"children": 1,
"education": "university_degree",
"housing_tenure": "rental",
"housing_type": "apartment",
"company_sector": "technology_telecommunications"
},
"financial_instruments": [
{
"type": "bank_account",
"currency": "EUR",
"iban": "ES9121000418450200051332",
"status": "not_verified"
}
]
},
"product_data": {
"loan_amount": 10000,
"loan_purpose": "home_improvement",
"loan_term_months": 36
},
"consents": {
"entries": [
{
"type": "terms",
"accepted": true,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v3.2",
"document_url": "https://publisher.com/legal/terms/v3.2"
},
{
"type": "privacy_policy",
"accepted": true,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v4.1",
"document_url": "https://publisher.com/legal/privacy/v4.1"
},
{
"type": "marketing",
"accepted": false,
"accepted_at": null,
"version": "v2.0"
}
],
"metadata": {
"ip_address": "84.23.12.55",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
"collected_at": "2026-02-16T10:22:31Z"
}
},
"tracking": {
"click_id": "abc123xyz",
"sub_id": "publisher_sub_1",
"campaign_id": "camp_789",
"source": "https://www.example.com"
}
}
'import requests
url = "https://{tenant}.techea.eu/api/v1/lead"
payload = {
"product_id": "36068625-4707-4ef8-a419-2aad1483db49",
"publisher_id": "b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b",
"customer": {
"external_id": "pub-12345-abc",
"personal_data": {
"first_name": "John",
"last_name": "Smith",
"second_surname": "Johnson",
"birthday": "1988-05-10",
"identification_number": "12345678A",
"nacionality": "ES",
"gender": "male"
},
"contact": {
"email": {
"address": "john.smith@email.com",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
},
"phone": {
"area_code": "+34",
"number": "600111222",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
}
},
"address": {
"street": "Calle Mayor",
"house": "1",
"city": "Madrid",
"region": "Madrid",
"postal_code": "28001",
"country": "ES"
},
"profile": {
"occupation": "self_employed",
"monthly_income": 2500,
"monthly_expenses": 1500,
"marital_status": "married",
"children": 1,
"education": "university_degree",
"housing_tenure": "rental",
"housing_type": "apartment",
"company_sector": "technology_telecommunications"
},
"financial_instruments": [
{
"type": "bank_account",
"currency": "EUR",
"iban": "ES9121000418450200051332",
"status": "not_verified"
}
]
},
"product_data": {
"loan_amount": 10000,
"loan_purpose": "home_improvement",
"loan_term_months": 36
},
"consents": {
"entries": [
{
"type": "terms",
"accepted": True,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v3.2",
"document_url": "https://publisher.com/legal/terms/v3.2"
},
{
"type": "privacy_policy",
"accepted": True,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v4.1",
"document_url": "https://publisher.com/legal/privacy/v4.1"
},
{
"type": "marketing",
"accepted": False,
"accepted_at": None,
"version": "v2.0"
}
],
"metadata": {
"ip_address": "84.23.12.55",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
"collected_at": "2026-02-16T10:22:31Z"
}
},
"tracking": {
"click_id": "abc123xyz",
"sub_id": "publisher_sub_1",
"campaign_id": "camp_789",
"source": "https://www.example.com"
}
}
headers = {
"apikey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
product_id: '36068625-4707-4ef8-a419-2aad1483db49',
publisher_id: 'b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b',
customer: {
external_id: 'pub-12345-abc',
personal_data: {
first_name: 'John',
last_name: 'Smith',
second_surname: 'Johnson',
birthday: '1988-05-10',
identification_number: '12345678A',
nacionality: 'ES',
gender: 'male'
},
contact: {
email: {
address: 'john.smith@email.com',
status: 'verified',
verified_at: '2026-02-01T10:00:00Z',
verification_method: 'otp'
},
phone: {
area_code: '+34',
number: '600111222',
status: 'verified',
verified_at: '2026-02-01T10:00:00Z',
verification_method: 'otp'
}
},
address: {
street: 'Calle Mayor',
house: '1',
city: 'Madrid',
region: 'Madrid',
postal_code: '28001',
country: 'ES'
},
profile: {
occupation: 'self_employed',
monthly_income: 2500,
monthly_expenses: 1500,
marital_status: 'married',
children: 1,
education: 'university_degree',
housing_tenure: 'rental',
housing_type: 'apartment',
company_sector: 'technology_telecommunications'
},
financial_instruments: [
{
type: 'bank_account',
currency: 'EUR',
iban: 'ES9121000418450200051332',
status: 'not_verified'
}
]
},
product_data: {loan_amount: 10000, loan_purpose: 'home_improvement', loan_term_months: 36},
consents: {
entries: [
{
type: 'terms',
accepted: true,
accepted_at: '2026-02-16T10:22:31Z',
version: 'v3.2',
document_url: 'https://publisher.com/legal/terms/v3.2'
},
{
type: 'privacy_policy',
accepted: true,
accepted_at: '2026-02-16T10:22:31Z',
version: 'v4.1',
document_url: 'https://publisher.com/legal/privacy/v4.1'
},
{type: 'marketing', accepted: false, accepted_at: null, version: 'v2.0'}
],
metadata: {
ip_address: '84.23.12.55',
user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
collected_at: '2026-02-16T10:22:31Z'
}
},
tracking: {
click_id: 'abc123xyz',
sub_id: 'publisher_sub_1',
campaign_id: 'camp_789',
source: 'https://www.example.com'
}
})
};
fetch('https://{tenant}.techea.eu/api/v1/lead', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{tenant}.techea.eu/api/v1/lead",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'product_id' => '36068625-4707-4ef8-a419-2aad1483db49',
'publisher_id' => 'b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b',
'customer' => [
'external_id' => 'pub-12345-abc',
'personal_data' => [
'first_name' => 'John',
'last_name' => 'Smith',
'second_surname' => 'Johnson',
'birthday' => '1988-05-10',
'identification_number' => '12345678A',
'nacionality' => 'ES',
'gender' => 'male'
],
'contact' => [
'email' => [
'address' => 'john.smith@email.com',
'status' => 'verified',
'verified_at' => '2026-02-01T10:00:00Z',
'verification_method' => 'otp'
],
'phone' => [
'area_code' => '+34',
'number' => '600111222',
'status' => 'verified',
'verified_at' => '2026-02-01T10:00:00Z',
'verification_method' => 'otp'
]
],
'address' => [
'street' => 'Calle Mayor',
'house' => '1',
'city' => 'Madrid',
'region' => 'Madrid',
'postal_code' => '28001',
'country' => 'ES'
],
'profile' => [
'occupation' => 'self_employed',
'monthly_income' => 2500,
'monthly_expenses' => 1500,
'marital_status' => 'married',
'children' => 1,
'education' => 'university_degree',
'housing_tenure' => 'rental',
'housing_type' => 'apartment',
'company_sector' => 'technology_telecommunications'
],
'financial_instruments' => [
[
'type' => 'bank_account',
'currency' => 'EUR',
'iban' => 'ES9121000418450200051332',
'status' => 'not_verified'
]
]
],
'product_data' => [
'loan_amount' => 10000,
'loan_purpose' => 'home_improvement',
'loan_term_months' => 36
],
'consents' => [
'entries' => [
[
'type' => 'terms',
'accepted' => true,
'accepted_at' => '2026-02-16T10:22:31Z',
'version' => 'v3.2',
'document_url' => 'https://publisher.com/legal/terms/v3.2'
],
[
'type' => 'privacy_policy',
'accepted' => true,
'accepted_at' => '2026-02-16T10:22:31Z',
'version' => 'v4.1',
'document_url' => 'https://publisher.com/legal/privacy/v4.1'
],
[
'type' => 'marketing',
'accepted' => false,
'accepted_at' => null,
'version' => 'v2.0'
]
],
'metadata' => [
'ip_address' => '84.23.12.55',
'user_agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
'collected_at' => '2026-02-16T10:22:31Z'
]
],
'tracking' => [
'click_id' => 'abc123xyz',
'sub_id' => 'publisher_sub_1',
'campaign_id' => 'camp_789',
'source' => 'https://www.example.com'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apikey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{tenant}.techea.eu/api/v1/lead"
payload := strings.NewReader("{\n \"product_id\": \"36068625-4707-4ef8-a419-2aad1483db49\",\n \"publisher_id\": \"b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b\",\n \"customer\": {\n \"external_id\": \"pub-12345-abc\",\n \"personal_data\": {\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"second_surname\": \"Johnson\",\n \"birthday\": \"1988-05-10\",\n \"identification_number\": \"12345678A\",\n \"nacionality\": \"ES\",\n \"gender\": \"male\"\n },\n \"contact\": {\n \"email\": {\n \"address\": \"john.smith@email.com\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n },\n \"phone\": {\n \"area_code\": \"+34\",\n \"number\": \"600111222\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n }\n },\n \"address\": {\n \"street\": \"Calle Mayor\",\n \"house\": \"1\",\n \"city\": \"Madrid\",\n \"region\": \"Madrid\",\n \"postal_code\": \"28001\",\n \"country\": \"ES\"\n },\n \"profile\": {\n \"occupation\": \"self_employed\",\n \"monthly_income\": 2500,\n \"monthly_expenses\": 1500,\n \"marital_status\": \"married\",\n \"children\": 1,\n \"education\": \"university_degree\",\n \"housing_tenure\": \"rental\",\n \"housing_type\": \"apartment\",\n \"company_sector\": \"technology_telecommunications\"\n },\n \"financial_instruments\": [\n {\n \"type\": \"bank_account\",\n \"currency\": \"EUR\",\n \"iban\": \"ES9121000418450200051332\",\n \"status\": \"not_verified\"\n }\n ]\n },\n \"product_data\": {\n \"loan_amount\": 10000,\n \"loan_purpose\": \"home_improvement\",\n \"loan_term_months\": 36\n },\n \"consents\": {\n \"entries\": [\n {\n \"type\": \"terms\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v3.2\",\n \"document_url\": \"https://publisher.com/legal/terms/v3.2\"\n },\n {\n \"type\": \"privacy_policy\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v4.1\",\n \"document_url\": \"https://publisher.com/legal/privacy/v4.1\"\n },\n {\n \"type\": \"marketing\",\n \"accepted\": false,\n \"accepted_at\": null,\n \"version\": \"v2.0\"\n }\n ],\n \"metadata\": {\n \"ip_address\": \"84.23.12.55\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"collected_at\": \"2026-02-16T10:22:31Z\"\n }\n },\n \"tracking\": {\n \"click_id\": \"abc123xyz\",\n \"sub_id\": \"publisher_sub_1\",\n \"campaign_id\": \"camp_789\",\n \"source\": \"https://www.example.com\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apikey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{tenant}.techea.eu/api/v1/lead")
.header("apikey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"product_id\": \"36068625-4707-4ef8-a419-2aad1483db49\",\n \"publisher_id\": \"b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b\",\n \"customer\": {\n \"external_id\": \"pub-12345-abc\",\n \"personal_data\": {\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"second_surname\": \"Johnson\",\n \"birthday\": \"1988-05-10\",\n \"identification_number\": \"12345678A\",\n \"nacionality\": \"ES\",\n \"gender\": \"male\"\n },\n \"contact\": {\n \"email\": {\n \"address\": \"john.smith@email.com\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n },\n \"phone\": {\n \"area_code\": \"+34\",\n \"number\": \"600111222\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n }\n },\n \"address\": {\n \"street\": \"Calle Mayor\",\n \"house\": \"1\",\n \"city\": \"Madrid\",\n \"region\": \"Madrid\",\n \"postal_code\": \"28001\",\n \"country\": \"ES\"\n },\n \"profile\": {\n \"occupation\": \"self_employed\",\n \"monthly_income\": 2500,\n \"monthly_expenses\": 1500,\n \"marital_status\": \"married\",\n \"children\": 1,\n \"education\": \"university_degree\",\n \"housing_tenure\": \"rental\",\n \"housing_type\": \"apartment\",\n \"company_sector\": \"technology_telecommunications\"\n },\n \"financial_instruments\": [\n {\n \"type\": \"bank_account\",\n \"currency\": \"EUR\",\n \"iban\": \"ES9121000418450200051332\",\n \"status\": \"not_verified\"\n }\n ]\n },\n \"product_data\": {\n \"loan_amount\": 10000,\n \"loan_purpose\": \"home_improvement\",\n \"loan_term_months\": 36\n },\n \"consents\": {\n \"entries\": [\n {\n \"type\": \"terms\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v3.2\",\n \"document_url\": \"https://publisher.com/legal/terms/v3.2\"\n },\n {\n \"type\": \"privacy_policy\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v4.1\",\n \"document_url\": \"https://publisher.com/legal/privacy/v4.1\"\n },\n {\n \"type\": \"marketing\",\n \"accepted\": false,\n \"accepted_at\": null,\n \"version\": \"v2.0\"\n }\n ],\n \"metadata\": {\n \"ip_address\": \"84.23.12.55\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"collected_at\": \"2026-02-16T10:22:31Z\"\n }\n },\n \"tracking\": {\n \"click_id\": \"abc123xyz\",\n \"sub_id\": \"publisher_sub_1\",\n \"campaign_id\": \"camp_789\",\n \"source\": \"https://www.example.com\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{tenant}.techea.eu/api/v1/lead")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"product_id\": \"36068625-4707-4ef8-a419-2aad1483db49\",\n \"publisher_id\": \"b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b\",\n \"customer\": {\n \"external_id\": \"pub-12345-abc\",\n \"personal_data\": {\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"second_surname\": \"Johnson\",\n \"birthday\": \"1988-05-10\",\n \"identification_number\": \"12345678A\",\n \"nacionality\": \"ES\",\n \"gender\": \"male\"\n },\n \"contact\": {\n \"email\": {\n \"address\": \"john.smith@email.com\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n },\n \"phone\": {\n \"area_code\": \"+34\",\n \"number\": \"600111222\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n }\n },\n \"address\": {\n \"street\": \"Calle Mayor\",\n \"house\": \"1\",\n \"city\": \"Madrid\",\n \"region\": \"Madrid\",\n \"postal_code\": \"28001\",\n \"country\": \"ES\"\n },\n \"profile\": {\n \"occupation\": \"self_employed\",\n \"monthly_income\": 2500,\n \"monthly_expenses\": 1500,\n \"marital_status\": \"married\",\n \"children\": 1,\n \"education\": \"university_degree\",\n \"housing_tenure\": \"rental\",\n \"housing_type\": \"apartment\",\n \"company_sector\": \"technology_telecommunications\"\n },\n \"financial_instruments\": [\n {\n \"type\": \"bank_account\",\n \"currency\": \"EUR\",\n \"iban\": \"ES9121000418450200051332\",\n \"status\": \"not_verified\"\n }\n ]\n },\n \"product_data\": {\n \"loan_amount\": 10000,\n \"loan_purpose\": \"home_improvement\",\n \"loan_term_months\": 36\n },\n \"consents\": {\n \"entries\": [\n {\n \"type\": \"terms\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v3.2\",\n \"document_url\": \"https://publisher.com/legal/terms/v3.2\"\n },\n {\n \"type\": \"privacy_policy\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v4.1\",\n \"document_url\": \"https://publisher.com/legal/privacy/v4.1\"\n },\n {\n \"type\": \"marketing\",\n \"accepted\": false,\n \"accepted_at\": null,\n \"version\": \"v2.0\"\n }\n ],\n \"metadata\": {\n \"ip_address\": \"84.23.12.55\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"collected_at\": \"2026-02-16T10:22:31Z\"\n }\n },\n \"tracking\": {\n \"click_id\": \"abc123xyz\",\n \"sub_id\": \"publisher_sub_1\",\n \"campaign_id\": \"camp_789\",\n \"source\": \"https://www.example.com\"\n }\n}"
response = http.request(request)
puts response.read_body{
"lead_id": "a1b2c3d4-0000-0000-0000-111122223333",
"status": "new"
}Publisher
Submit Lead
Submits a customer application. Leadhub validates the data, checks eligibility and distributes the lead to matching advertisers in real time.
Required fields
product_id: ID of the product the customer is applying forpublisher_id: Your publisher IDcustomer.personal_data: first name and last name are requiredcustomer.contact.email: the customer’s unique identifier in the systemproduct_data: loan amount, purpose and termconsents: customer must have accepted consents of typetermsandprivacy_policy
Rejection reasons
| Reason | Description |
|---|---|
customer_already_exists | A customer with this email is already in the system |
duplicate_submission | This customer was submitted too recently |
eligibility_failed | Customer does not meet eligibility criteria |
age_restriction | Customer’s age is outside the accepted range |
income_insufficient | Customer’s income is below the minimum threshold |
geographic_restriction | Customer’s location is not supported |
consents_missing | Required consents were not accepted |
invalid_product | Product not found or not active |
blacklisted | Customer is on the internal blacklist |
fraud_suspected | Fraud signals detected in the submission |
POST
/
lead
Submit lead
curl --request POST \
--url https://{tenant}.techea.eu/api/v1/lead \
--header 'Content-Type: application/json' \
--header 'apikey: <api-key>' \
--data '
{
"product_id": "36068625-4707-4ef8-a419-2aad1483db49",
"publisher_id": "b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b",
"customer": {
"external_id": "pub-12345-abc",
"personal_data": {
"first_name": "John",
"last_name": "Smith",
"second_surname": "Johnson",
"birthday": "1988-05-10",
"identification_number": "12345678A",
"nacionality": "ES",
"gender": "male"
},
"contact": {
"email": {
"address": "john.smith@email.com",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
},
"phone": {
"area_code": "+34",
"number": "600111222",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
}
},
"address": {
"street": "Calle Mayor",
"house": "1",
"city": "Madrid",
"region": "Madrid",
"postal_code": "28001",
"country": "ES"
},
"profile": {
"occupation": "self_employed",
"monthly_income": 2500,
"monthly_expenses": 1500,
"marital_status": "married",
"children": 1,
"education": "university_degree",
"housing_tenure": "rental",
"housing_type": "apartment",
"company_sector": "technology_telecommunications"
},
"financial_instruments": [
{
"type": "bank_account",
"currency": "EUR",
"iban": "ES9121000418450200051332",
"status": "not_verified"
}
]
},
"product_data": {
"loan_amount": 10000,
"loan_purpose": "home_improvement",
"loan_term_months": 36
},
"consents": {
"entries": [
{
"type": "terms",
"accepted": true,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v3.2",
"document_url": "https://publisher.com/legal/terms/v3.2"
},
{
"type": "privacy_policy",
"accepted": true,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v4.1",
"document_url": "https://publisher.com/legal/privacy/v4.1"
},
{
"type": "marketing",
"accepted": false,
"accepted_at": null,
"version": "v2.0"
}
],
"metadata": {
"ip_address": "84.23.12.55",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
"collected_at": "2026-02-16T10:22:31Z"
}
},
"tracking": {
"click_id": "abc123xyz",
"sub_id": "publisher_sub_1",
"campaign_id": "camp_789",
"source": "https://www.example.com"
}
}
'import requests
url = "https://{tenant}.techea.eu/api/v1/lead"
payload = {
"product_id": "36068625-4707-4ef8-a419-2aad1483db49",
"publisher_id": "b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b",
"customer": {
"external_id": "pub-12345-abc",
"personal_data": {
"first_name": "John",
"last_name": "Smith",
"second_surname": "Johnson",
"birthday": "1988-05-10",
"identification_number": "12345678A",
"nacionality": "ES",
"gender": "male"
},
"contact": {
"email": {
"address": "john.smith@email.com",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
},
"phone": {
"area_code": "+34",
"number": "600111222",
"status": "verified",
"verified_at": "2026-02-01T10:00:00Z",
"verification_method": "otp"
}
},
"address": {
"street": "Calle Mayor",
"house": "1",
"city": "Madrid",
"region": "Madrid",
"postal_code": "28001",
"country": "ES"
},
"profile": {
"occupation": "self_employed",
"monthly_income": 2500,
"monthly_expenses": 1500,
"marital_status": "married",
"children": 1,
"education": "university_degree",
"housing_tenure": "rental",
"housing_type": "apartment",
"company_sector": "technology_telecommunications"
},
"financial_instruments": [
{
"type": "bank_account",
"currency": "EUR",
"iban": "ES9121000418450200051332",
"status": "not_verified"
}
]
},
"product_data": {
"loan_amount": 10000,
"loan_purpose": "home_improvement",
"loan_term_months": 36
},
"consents": {
"entries": [
{
"type": "terms",
"accepted": True,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v3.2",
"document_url": "https://publisher.com/legal/terms/v3.2"
},
{
"type": "privacy_policy",
"accepted": True,
"accepted_at": "2026-02-16T10:22:31Z",
"version": "v4.1",
"document_url": "https://publisher.com/legal/privacy/v4.1"
},
{
"type": "marketing",
"accepted": False,
"accepted_at": None,
"version": "v2.0"
}
],
"metadata": {
"ip_address": "84.23.12.55",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
"collected_at": "2026-02-16T10:22:31Z"
}
},
"tracking": {
"click_id": "abc123xyz",
"sub_id": "publisher_sub_1",
"campaign_id": "camp_789",
"source": "https://www.example.com"
}
}
headers = {
"apikey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
product_id: '36068625-4707-4ef8-a419-2aad1483db49',
publisher_id: 'b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b',
customer: {
external_id: 'pub-12345-abc',
personal_data: {
first_name: 'John',
last_name: 'Smith',
second_surname: 'Johnson',
birthday: '1988-05-10',
identification_number: '12345678A',
nacionality: 'ES',
gender: 'male'
},
contact: {
email: {
address: 'john.smith@email.com',
status: 'verified',
verified_at: '2026-02-01T10:00:00Z',
verification_method: 'otp'
},
phone: {
area_code: '+34',
number: '600111222',
status: 'verified',
verified_at: '2026-02-01T10:00:00Z',
verification_method: 'otp'
}
},
address: {
street: 'Calle Mayor',
house: '1',
city: 'Madrid',
region: 'Madrid',
postal_code: '28001',
country: 'ES'
},
profile: {
occupation: 'self_employed',
monthly_income: 2500,
monthly_expenses: 1500,
marital_status: 'married',
children: 1,
education: 'university_degree',
housing_tenure: 'rental',
housing_type: 'apartment',
company_sector: 'technology_telecommunications'
},
financial_instruments: [
{
type: 'bank_account',
currency: 'EUR',
iban: 'ES9121000418450200051332',
status: 'not_verified'
}
]
},
product_data: {loan_amount: 10000, loan_purpose: 'home_improvement', loan_term_months: 36},
consents: {
entries: [
{
type: 'terms',
accepted: true,
accepted_at: '2026-02-16T10:22:31Z',
version: 'v3.2',
document_url: 'https://publisher.com/legal/terms/v3.2'
},
{
type: 'privacy_policy',
accepted: true,
accepted_at: '2026-02-16T10:22:31Z',
version: 'v4.1',
document_url: 'https://publisher.com/legal/privacy/v4.1'
},
{type: 'marketing', accepted: false, accepted_at: null, version: 'v2.0'}
],
metadata: {
ip_address: '84.23.12.55',
user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
collected_at: '2026-02-16T10:22:31Z'
}
},
tracking: {
click_id: 'abc123xyz',
sub_id: 'publisher_sub_1',
campaign_id: 'camp_789',
source: 'https://www.example.com'
}
})
};
fetch('https://{tenant}.techea.eu/api/v1/lead', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{tenant}.techea.eu/api/v1/lead",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'product_id' => '36068625-4707-4ef8-a419-2aad1483db49',
'publisher_id' => 'b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b',
'customer' => [
'external_id' => 'pub-12345-abc',
'personal_data' => [
'first_name' => 'John',
'last_name' => 'Smith',
'second_surname' => 'Johnson',
'birthday' => '1988-05-10',
'identification_number' => '12345678A',
'nacionality' => 'ES',
'gender' => 'male'
],
'contact' => [
'email' => [
'address' => 'john.smith@email.com',
'status' => 'verified',
'verified_at' => '2026-02-01T10:00:00Z',
'verification_method' => 'otp'
],
'phone' => [
'area_code' => '+34',
'number' => '600111222',
'status' => 'verified',
'verified_at' => '2026-02-01T10:00:00Z',
'verification_method' => 'otp'
]
],
'address' => [
'street' => 'Calle Mayor',
'house' => '1',
'city' => 'Madrid',
'region' => 'Madrid',
'postal_code' => '28001',
'country' => 'ES'
],
'profile' => [
'occupation' => 'self_employed',
'monthly_income' => 2500,
'monthly_expenses' => 1500,
'marital_status' => 'married',
'children' => 1,
'education' => 'university_degree',
'housing_tenure' => 'rental',
'housing_type' => 'apartment',
'company_sector' => 'technology_telecommunications'
],
'financial_instruments' => [
[
'type' => 'bank_account',
'currency' => 'EUR',
'iban' => 'ES9121000418450200051332',
'status' => 'not_verified'
]
]
],
'product_data' => [
'loan_amount' => 10000,
'loan_purpose' => 'home_improvement',
'loan_term_months' => 36
],
'consents' => [
'entries' => [
[
'type' => 'terms',
'accepted' => true,
'accepted_at' => '2026-02-16T10:22:31Z',
'version' => 'v3.2',
'document_url' => 'https://publisher.com/legal/terms/v3.2'
],
[
'type' => 'privacy_policy',
'accepted' => true,
'accepted_at' => '2026-02-16T10:22:31Z',
'version' => 'v4.1',
'document_url' => 'https://publisher.com/legal/privacy/v4.1'
],
[
'type' => 'marketing',
'accepted' => false,
'accepted_at' => null,
'version' => 'v2.0'
]
],
'metadata' => [
'ip_address' => '84.23.12.55',
'user_agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
'collected_at' => '2026-02-16T10:22:31Z'
]
],
'tracking' => [
'click_id' => 'abc123xyz',
'sub_id' => 'publisher_sub_1',
'campaign_id' => 'camp_789',
'source' => 'https://www.example.com'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apikey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{tenant}.techea.eu/api/v1/lead"
payload := strings.NewReader("{\n \"product_id\": \"36068625-4707-4ef8-a419-2aad1483db49\",\n \"publisher_id\": \"b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b\",\n \"customer\": {\n \"external_id\": \"pub-12345-abc\",\n \"personal_data\": {\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"second_surname\": \"Johnson\",\n \"birthday\": \"1988-05-10\",\n \"identification_number\": \"12345678A\",\n \"nacionality\": \"ES\",\n \"gender\": \"male\"\n },\n \"contact\": {\n \"email\": {\n \"address\": \"john.smith@email.com\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n },\n \"phone\": {\n \"area_code\": \"+34\",\n \"number\": \"600111222\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n }\n },\n \"address\": {\n \"street\": \"Calle Mayor\",\n \"house\": \"1\",\n \"city\": \"Madrid\",\n \"region\": \"Madrid\",\n \"postal_code\": \"28001\",\n \"country\": \"ES\"\n },\n \"profile\": {\n \"occupation\": \"self_employed\",\n \"monthly_income\": 2500,\n \"monthly_expenses\": 1500,\n \"marital_status\": \"married\",\n \"children\": 1,\n \"education\": \"university_degree\",\n \"housing_tenure\": \"rental\",\n \"housing_type\": \"apartment\",\n \"company_sector\": \"technology_telecommunications\"\n },\n \"financial_instruments\": [\n {\n \"type\": \"bank_account\",\n \"currency\": \"EUR\",\n \"iban\": \"ES9121000418450200051332\",\n \"status\": \"not_verified\"\n }\n ]\n },\n \"product_data\": {\n \"loan_amount\": 10000,\n \"loan_purpose\": \"home_improvement\",\n \"loan_term_months\": 36\n },\n \"consents\": {\n \"entries\": [\n {\n \"type\": \"terms\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v3.2\",\n \"document_url\": \"https://publisher.com/legal/terms/v3.2\"\n },\n {\n \"type\": \"privacy_policy\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v4.1\",\n \"document_url\": \"https://publisher.com/legal/privacy/v4.1\"\n },\n {\n \"type\": \"marketing\",\n \"accepted\": false,\n \"accepted_at\": null,\n \"version\": \"v2.0\"\n }\n ],\n \"metadata\": {\n \"ip_address\": \"84.23.12.55\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"collected_at\": \"2026-02-16T10:22:31Z\"\n }\n },\n \"tracking\": {\n \"click_id\": \"abc123xyz\",\n \"sub_id\": \"publisher_sub_1\",\n \"campaign_id\": \"camp_789\",\n \"source\": \"https://www.example.com\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apikey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{tenant}.techea.eu/api/v1/lead")
.header("apikey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"product_id\": \"36068625-4707-4ef8-a419-2aad1483db49\",\n \"publisher_id\": \"b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b\",\n \"customer\": {\n \"external_id\": \"pub-12345-abc\",\n \"personal_data\": {\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"second_surname\": \"Johnson\",\n \"birthday\": \"1988-05-10\",\n \"identification_number\": \"12345678A\",\n \"nacionality\": \"ES\",\n \"gender\": \"male\"\n },\n \"contact\": {\n \"email\": {\n \"address\": \"john.smith@email.com\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n },\n \"phone\": {\n \"area_code\": \"+34\",\n \"number\": \"600111222\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n }\n },\n \"address\": {\n \"street\": \"Calle Mayor\",\n \"house\": \"1\",\n \"city\": \"Madrid\",\n \"region\": \"Madrid\",\n \"postal_code\": \"28001\",\n \"country\": \"ES\"\n },\n \"profile\": {\n \"occupation\": \"self_employed\",\n \"monthly_income\": 2500,\n \"monthly_expenses\": 1500,\n \"marital_status\": \"married\",\n \"children\": 1,\n \"education\": \"university_degree\",\n \"housing_tenure\": \"rental\",\n \"housing_type\": \"apartment\",\n \"company_sector\": \"technology_telecommunications\"\n },\n \"financial_instruments\": [\n {\n \"type\": \"bank_account\",\n \"currency\": \"EUR\",\n \"iban\": \"ES9121000418450200051332\",\n \"status\": \"not_verified\"\n }\n ]\n },\n \"product_data\": {\n \"loan_amount\": 10000,\n \"loan_purpose\": \"home_improvement\",\n \"loan_term_months\": 36\n },\n \"consents\": {\n \"entries\": [\n {\n \"type\": \"terms\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v3.2\",\n \"document_url\": \"https://publisher.com/legal/terms/v3.2\"\n },\n {\n \"type\": \"privacy_policy\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v4.1\",\n \"document_url\": \"https://publisher.com/legal/privacy/v4.1\"\n },\n {\n \"type\": \"marketing\",\n \"accepted\": false,\n \"accepted_at\": null,\n \"version\": \"v2.0\"\n }\n ],\n \"metadata\": {\n \"ip_address\": \"84.23.12.55\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"collected_at\": \"2026-02-16T10:22:31Z\"\n }\n },\n \"tracking\": {\n \"click_id\": \"abc123xyz\",\n \"sub_id\": \"publisher_sub_1\",\n \"campaign_id\": \"camp_789\",\n \"source\": \"https://www.example.com\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{tenant}.techea.eu/api/v1/lead")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"product_id\": \"36068625-4707-4ef8-a419-2aad1483db49\",\n \"publisher_id\": \"b96bdbc6-437a-4e2f-9b0e-2d91a5767f3b\",\n \"customer\": {\n \"external_id\": \"pub-12345-abc\",\n \"personal_data\": {\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"second_surname\": \"Johnson\",\n \"birthday\": \"1988-05-10\",\n \"identification_number\": \"12345678A\",\n \"nacionality\": \"ES\",\n \"gender\": \"male\"\n },\n \"contact\": {\n \"email\": {\n \"address\": \"john.smith@email.com\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n },\n \"phone\": {\n \"area_code\": \"+34\",\n \"number\": \"600111222\",\n \"status\": \"verified\",\n \"verified_at\": \"2026-02-01T10:00:00Z\",\n \"verification_method\": \"otp\"\n }\n },\n \"address\": {\n \"street\": \"Calle Mayor\",\n \"house\": \"1\",\n \"city\": \"Madrid\",\n \"region\": \"Madrid\",\n \"postal_code\": \"28001\",\n \"country\": \"ES\"\n },\n \"profile\": {\n \"occupation\": \"self_employed\",\n \"monthly_income\": 2500,\n \"monthly_expenses\": 1500,\n \"marital_status\": \"married\",\n \"children\": 1,\n \"education\": \"university_degree\",\n \"housing_tenure\": \"rental\",\n \"housing_type\": \"apartment\",\n \"company_sector\": \"technology_telecommunications\"\n },\n \"financial_instruments\": [\n {\n \"type\": \"bank_account\",\n \"currency\": \"EUR\",\n \"iban\": \"ES9121000418450200051332\",\n \"status\": \"not_verified\"\n }\n ]\n },\n \"product_data\": {\n \"loan_amount\": 10000,\n \"loan_purpose\": \"home_improvement\",\n \"loan_term_months\": 36\n },\n \"consents\": {\n \"entries\": [\n {\n \"type\": \"terms\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v3.2\",\n \"document_url\": \"https://publisher.com/legal/terms/v3.2\"\n },\n {\n \"type\": \"privacy_policy\",\n \"accepted\": true,\n \"accepted_at\": \"2026-02-16T10:22:31Z\",\n \"version\": \"v4.1\",\n \"document_url\": \"https://publisher.com/legal/privacy/v4.1\"\n },\n {\n \"type\": \"marketing\",\n \"accepted\": false,\n \"accepted_at\": null,\n \"version\": \"v2.0\"\n }\n ],\n \"metadata\": {\n \"ip_address\": \"84.23.12.55\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\n \"collected_at\": \"2026-02-16T10:22:31Z\"\n }\n },\n \"tracking\": {\n \"click_id\": \"abc123xyz\",\n \"sub_id\": \"publisher_sub_1\",\n \"campaign_id\": \"camp_789\",\n \"source\": \"https://www.example.com\"\n }\n}"
response = http.request(request)
puts response.read_body{
"lead_id": "a1b2c3d4-0000-0000-0000-111122223333",
"status": "new"
}Authorizations
API Key provided by TECHEA
Body
application/json
ID of the product the customer is applying for. Provided by TECHEA.
Your publisher ID in TECHEA.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Optional campaign attribution data
Show child attributes
Show child attributes
Response
Lead received and processed. Check the status field:
new: lead accepted — no advertiser match yet, do not redirectdistributed: lead distributed to at least one advertiser — redirect customer toredirect_urlrejected: lead not accepted — checkrejection_reason
ID generated by TECHEA. Used for advertiser event tracking.
Null if the lead was rejected before being created (e.g. customer_already_exists).
Lead status from the publisher's perspective:
new: lead accepted — no advertiser match yet, do not redirectdistributed: lead sent to at least one advertiser — redirect customer toredirect_urlrejected: not accepted — checkrejection_reason
Available options:
new, distributed, rejected URL to redirect the customer to complete the process.
Only present when status = distributed.
Reason for rejection. Only present when status = rejected.
Available options:
customer_already_exists, duplicate_submission, eligibility_failed, age_restriction, income_insufficient, geographic_restriction, consents_missing, invalid_product, blacklisted, fraud_suspected, null ⌘I