Skip to main content
PUT
/
api
/
v2
/
network
/
leads
/
update
Update lead
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": {}
  }
}
{
"message": "Request could not be parsed.",
"success": false,
"info": {
"errors": {}
}
}
{
"message": "API key is invalid or missing.",
"success": false
}
{
"message": "This endpoint is not available for your role.",
"success": false
}
{
"message": "Resource not found.",
"success": false
}
{
"message": "Validation error",
"success": false,
"info": {
"errors": {
"email": [
"Email cannot be blank."
],
"currency": [
"Currency must be a valid ISO code."
]
}
}
}
{
"message": "An unexpected error occurred.",
"success": false,
"info": {
"errors": {}
}
}

Authorizations

X-API-Key
string
header
required

Preferred authentication method. Pass the API key in the X-API-Key HTTP request header. The user account must have api_status enabled.

Body

application/json
lead_id
string
required

Lead UUID (required for update).

transaction_id
string

Lead transaction UUID.

click_id
string

Click UUID.

conv_status
enum<string>
Available options:
pending,
approved,
rejected,
hold
revenue
number

Revenue amount override.

payout
number

Affiliate payout override.

amount
number

Sale amount override.

adv_order_id
string

Advertiser order identifier.

adv_user_id
string

Advertiser user identifier.

adv_track_id
string

Advertiser tracking ID.

email
string

Lead email address.

firstname
string

Lead first name.

lastname
string

Lead last name.

phone
string

Lead phone number.

gender
enum<string>

Lead gender: m=male, f=female.

Available options:
m,
f
birthday
string<date>

Lead date of birth (YYYY-MM-DD).

address
string

Lead street address.

city
string

Lead city.

region
string

Lead region/state.

postcode
string

Lead postal/ZIP code.

country
string

Lead country code.

vertical
string

Industry vertical identifier.

custom1
string

Custom data field 1.

custom2
string

Custom data field 2.

custom3
string

Custom data field 3.

custom4
string

Custom data field 4.

custom5
string

Custom data field 5.

custom6
string

Custom data field 6.

custom7
string

Custom data field 7.

custom8
string

Custom data field 8.

custom9
string

Custom data field 9.

custom10
string

Custom data field 10.

public_notes
string

Note visible to the affiliate.

private_notes
string

Internal note, not visible to the affiliate.

Response

Lead updated.

status
string
Example:

"success"

code
integer
Example:

200

name
string
Example:

"OK"

message
string
info
object