curl --request PUT \
--url https://{domain}/api/v2/network/leads/update \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"lead_id": "string",
"transaction_id": "string",
"click_id": "string",
"conv_status": "pending",
"revenue": 1,
"payout": 1
}
'import requests
url = "https://{domain}/api/v2/network/leads/update"
payload = {
"lead_id": "string",
"transaction_id": "string",
"click_id": "string",
"conv_status": "pending",
"revenue": 1,
"payout": 1
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
lead_id: 'string',
transaction_id: 'string',
click_id: 'string',
conv_status: 'pending',
revenue: 1,
payout: 1
})
};
fetch('https://{domain}/api/v2/network/leads/update', 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://{domain}/api/v2/network/leads/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'lead_id' => 'string',
'transaction_id' => 'string',
'click_id' => 'string',
'conv_status' => 'pending',
'revenue' => 1,
'payout' => 1
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <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://{domain}/api/v2/network/leads/update"
payload := strings.NewReader("{\n \"lead_id\": \"string\",\n \"transaction_id\": \"string\",\n \"click_id\": \"string\",\n \"conv_status\": \"pending\",\n \"revenue\": 1,\n \"payout\": 1\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-Key", "<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.put("https://{domain}/api/v2/network/leads/update")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"lead_id\": \"string\",\n \"transaction_id\": \"string\",\n \"click_id\": \"string\",\n \"conv_status\": \"pending\",\n \"revenue\": 1,\n \"payout\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{domain}/api/v2/network/leads/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"lead_id\": \"string\",\n \"transaction_id\": \"string\",\n \"click_id\": \"string\",\n \"conv_status\": \"pending\",\n \"revenue\": 1,\n \"payout\": 1\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"code": 200,
"name": "OK",
"message": "<string>",
"info": {
"result": {}
}
}{
"status": "error",
"code": 400,
"name": "Bad Request",
"message": "Request could not be parsed.",
"info": {
"errors": {}
}
}{
"status": "error",
"code": 401,
"name": "Unauthorized",
"message": "API key is invalid or missing."
}{
"status": "error",
"code": 403,
"name": "Forbidden",
"message": "This endpoint is not available for your role."
}{
"status": "error",
"code": 404,
"name": "Not Found",
"message": "Resource not found."
}{
"status": "error",
"code": 422,
"name": "Unprocessable entity",
"message": "Validation error",
"info": {
"errors": {
"email": [
"Email cannot be blank."
],
"currency": [
"Currency must be a valid ISO code."
]
}
}
}{
"status": "error",
"code": 500,
"name": "Internal Server Error",
"message": "An unexpected error occurred.",
"info": {
"errors": {}
}
}Update lead
Updates an existing lead’s data.
curl --request PUT \
--url https://{domain}/api/v2/network/leads/update \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"lead_id": "string",
"transaction_id": "string",
"click_id": "string",
"conv_status": "pending",
"revenue": 1,
"payout": 1
}
'import requests
url = "https://{domain}/api/v2/network/leads/update"
payload = {
"lead_id": "string",
"transaction_id": "string",
"click_id": "string",
"conv_status": "pending",
"revenue": 1,
"payout": 1
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
lead_id: 'string',
transaction_id: 'string',
click_id: 'string',
conv_status: 'pending',
revenue: 1,
payout: 1
})
};
fetch('https://{domain}/api/v2/network/leads/update', 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://{domain}/api/v2/network/leads/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'lead_id' => 'string',
'transaction_id' => 'string',
'click_id' => 'string',
'conv_status' => 'pending',
'revenue' => 1,
'payout' => 1
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <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://{domain}/api/v2/network/leads/update"
payload := strings.NewReader("{\n \"lead_id\": \"string\",\n \"transaction_id\": \"string\",\n \"click_id\": \"string\",\n \"conv_status\": \"pending\",\n \"revenue\": 1,\n \"payout\": 1\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-Key", "<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.put("https://{domain}/api/v2/network/leads/update")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"lead_id\": \"string\",\n \"transaction_id\": \"string\",\n \"click_id\": \"string\",\n \"conv_status\": \"pending\",\n \"revenue\": 1,\n \"payout\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{domain}/api/v2/network/leads/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"lead_id\": \"string\",\n \"transaction_id\": \"string\",\n \"click_id\": \"string\",\n \"conv_status\": \"pending\",\n \"revenue\": 1,\n \"payout\": 1\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"code": 200,
"name": "OK",
"message": "<string>",
"info": {
"result": {}
}
}{
"status": "error",
"code": 400,
"name": "Bad Request",
"message": "Request could not be parsed.",
"info": {
"errors": {}
}
}{
"status": "error",
"code": 401,
"name": "Unauthorized",
"message": "API key is invalid or missing."
}{
"status": "error",
"code": 403,
"name": "Forbidden",
"message": "This endpoint is not available for your role."
}{
"status": "error",
"code": 404,
"name": "Not Found",
"message": "Resource not found."
}{
"status": "error",
"code": 422,
"name": "Unprocessable entity",
"message": "Validation error",
"info": {
"errors": {
"email": [
"Email cannot be blank."
],
"currency": [
"Currency must be a valid ISO code."
]
}
}
}{
"status": "error",
"code": 500,
"name": "Internal Server Error",
"message": "An unexpected error occurred.",
"info": {
"errors": {}
}
}Authorizations
Preferred authentication method. Pass the API key in the X-API-Key HTTP request header. The user account must have api_status enabled.
Body
Lead UUID (required for update).
Lead transaction UUID.
Click UUID.
pending, approved, rejected, hold Revenue amount override.
Affiliate payout override.
Sale amount override.
Advertiser order identifier.
Advertiser user identifier.
Advertiser tracking ID.
Lead email address.
Lead first name.
Lead last name.
Lead phone number.
Lead gender: m=male, f=female.
m, f Lead date of birth (YYYY-MM-DD).
Lead street address.
Lead city.
Lead region/state.
Lead postal/ZIP code.
Lead country code.
Industry vertical identifier.
Custom data field 1.
Custom data field 2.
Custom data field 3.
Custom data field 4.
Custom data field 5.
Custom data field 6.
Custom data field 7.
Custom data field 8.
Custom data field 9.
Custom data field 10.
Note visible to the affiliate.
Internal note, not visible to the affiliate.
Was this page helpful?