Create conversion event
curl --request POST \
--url https://api.getnexor.ai/api/public/conversions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"conversion_type_id": "123e4567-e89b-12d3-a456-426614174100",
"lead_id": "123e4567-e89b-12d3-a456-426614174200",
"amount": 85000,
"workflow_run_id": "123e4567-e89b-12d3-a456-426614174400",
"currency": "USD",
"converted_at": "2026-02-01T15:30:00Z",
"metadata": {
"property_unit": "Apt 302",
"broker": "John Smith",
"external_deal_id": "DEAL-1234"
},
"notes": "Client paid in cash, expedited closing.",
"lead_email": "<string>",
"lead_phone": "<string>"
}
'import requests
url = "https://api.getnexor.ai/api/public/conversions"
payload = {
"conversion_type_id": "123e4567-e89b-12d3-a456-426614174100",
"lead_id": "123e4567-e89b-12d3-a456-426614174200",
"amount": 85000,
"workflow_run_id": "123e4567-e89b-12d3-a456-426614174400",
"currency": "USD",
"converted_at": "2026-02-01T15:30:00Z",
"metadata": {
"property_unit": "Apt 302",
"broker": "John Smith",
"external_deal_id": "DEAL-1234"
},
"notes": "Client paid in cash, expedited closing.",
"lead_email": "<string>",
"lead_phone": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
conversion_type_id: '123e4567-e89b-12d3-a456-426614174100',
lead_id: '123e4567-e89b-12d3-a456-426614174200',
amount: 85000,
workflow_run_id: '123e4567-e89b-12d3-a456-426614174400',
currency: 'USD',
converted_at: '2026-02-01T15:30:00Z',
metadata: {property_unit: 'Apt 302', broker: 'John Smith', external_deal_id: 'DEAL-1234'},
notes: 'Client paid in cash, expedited closing.',
lead_email: '<string>',
lead_phone: '<string>'
})
};
fetch('https://api.getnexor.ai/api/public/conversions', 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://api.getnexor.ai/api/public/conversions",
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([
'conversion_type_id' => '123e4567-e89b-12d3-a456-426614174100',
'lead_id' => '123e4567-e89b-12d3-a456-426614174200',
'amount' => 85000,
'workflow_run_id' => '123e4567-e89b-12d3-a456-426614174400',
'currency' => 'USD',
'converted_at' => '2026-02-01T15:30:00Z',
'metadata' => [
'property_unit' => 'Apt 302',
'broker' => 'John Smith',
'external_deal_id' => 'DEAL-1234'
],
'notes' => 'Client paid in cash, expedited closing.',
'lead_email' => '<string>',
'lead_phone' => '<string>'
]),
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://api.getnexor.ai/api/public/conversions"
payload := strings.NewReader("{\n \"conversion_type_id\": \"123e4567-e89b-12d3-a456-426614174100\",\n \"lead_id\": \"123e4567-e89b-12d3-a456-426614174200\",\n \"amount\": 85000,\n \"workflow_run_id\": \"123e4567-e89b-12d3-a456-426614174400\",\n \"currency\": \"USD\",\n \"converted_at\": \"2026-02-01T15:30:00Z\",\n \"metadata\": {\n \"property_unit\": \"Apt 302\",\n \"broker\": \"John Smith\",\n \"external_deal_id\": \"DEAL-1234\"\n },\n \"notes\": \"Client paid in cash, expedited closing.\",\n \"lead_email\": \"<string>\",\n \"lead_phone\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.getnexor.ai/api/public/conversions")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"conversion_type_id\": \"123e4567-e89b-12d3-a456-426614174100\",\n \"lead_id\": \"123e4567-e89b-12d3-a456-426614174200\",\n \"amount\": 85000,\n \"workflow_run_id\": \"123e4567-e89b-12d3-a456-426614174400\",\n \"currency\": \"USD\",\n \"converted_at\": \"2026-02-01T15:30:00Z\",\n \"metadata\": {\n \"property_unit\": \"Apt 302\",\n \"broker\": \"John Smith\",\n \"external_deal_id\": \"DEAL-1234\"\n },\n \"notes\": \"Client paid in cash, expedited closing.\",\n \"lead_email\": \"<string>\",\n \"lead_phone\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getnexor.ai/api/public/conversions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"conversion_type_id\": \"123e4567-e89b-12d3-a456-426614174100\",\n \"lead_id\": \"123e4567-e89b-12d3-a456-426614174200\",\n \"amount\": 85000,\n \"workflow_run_id\": \"123e4567-e89b-12d3-a456-426614174400\",\n \"currency\": \"USD\",\n \"converted_at\": \"2026-02-01T15:30:00Z\",\n \"metadata\": {\n \"property_unit\": \"Apt 302\",\n \"broker\": \"John Smith\",\n \"external_deal_id\": \"DEAL-1234\"\n },\n \"notes\": \"Client paid in cash, expedited closing.\",\n \"lead_email\": \"<string>\",\n \"lead_phone\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"conversion_event": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversion_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": 123,
"currency": "<string>",
"converted_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"master_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"metadata": {},
"notes": "<string>",
"conversion_types": {
"name": "<string>",
"category": "intermediary",
"fields": [
{
"key": "property_unit",
"label": "Property / Unit",
"type": "text"
}
]
}
}
}Create Conversion Event
Record a conversion event using a lead ID, email address, or phone number. Safety note: A conversion type can asynchronously start a workflow transfer and status change after HTTP 201. A later failure does not roll back the conversion event.
POST
/
conversions
Create conversion event
curl --request POST \
--url https://api.getnexor.ai/api/public/conversions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"conversion_type_id": "123e4567-e89b-12d3-a456-426614174100",
"lead_id": "123e4567-e89b-12d3-a456-426614174200",
"amount": 85000,
"workflow_run_id": "123e4567-e89b-12d3-a456-426614174400",
"currency": "USD",
"converted_at": "2026-02-01T15:30:00Z",
"metadata": {
"property_unit": "Apt 302",
"broker": "John Smith",
"external_deal_id": "DEAL-1234"
},
"notes": "Client paid in cash, expedited closing.",
"lead_email": "<string>",
"lead_phone": "<string>"
}
'import requests
url = "https://api.getnexor.ai/api/public/conversions"
payload = {
"conversion_type_id": "123e4567-e89b-12d3-a456-426614174100",
"lead_id": "123e4567-e89b-12d3-a456-426614174200",
"amount": 85000,
"workflow_run_id": "123e4567-e89b-12d3-a456-426614174400",
"currency": "USD",
"converted_at": "2026-02-01T15:30:00Z",
"metadata": {
"property_unit": "Apt 302",
"broker": "John Smith",
"external_deal_id": "DEAL-1234"
},
"notes": "Client paid in cash, expedited closing.",
"lead_email": "<string>",
"lead_phone": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
conversion_type_id: '123e4567-e89b-12d3-a456-426614174100',
lead_id: '123e4567-e89b-12d3-a456-426614174200',
amount: 85000,
workflow_run_id: '123e4567-e89b-12d3-a456-426614174400',
currency: 'USD',
converted_at: '2026-02-01T15:30:00Z',
metadata: {property_unit: 'Apt 302', broker: 'John Smith', external_deal_id: 'DEAL-1234'},
notes: 'Client paid in cash, expedited closing.',
lead_email: '<string>',
lead_phone: '<string>'
})
};
fetch('https://api.getnexor.ai/api/public/conversions', 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://api.getnexor.ai/api/public/conversions",
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([
'conversion_type_id' => '123e4567-e89b-12d3-a456-426614174100',
'lead_id' => '123e4567-e89b-12d3-a456-426614174200',
'amount' => 85000,
'workflow_run_id' => '123e4567-e89b-12d3-a456-426614174400',
'currency' => 'USD',
'converted_at' => '2026-02-01T15:30:00Z',
'metadata' => [
'property_unit' => 'Apt 302',
'broker' => 'John Smith',
'external_deal_id' => 'DEAL-1234'
],
'notes' => 'Client paid in cash, expedited closing.',
'lead_email' => '<string>',
'lead_phone' => '<string>'
]),
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://api.getnexor.ai/api/public/conversions"
payload := strings.NewReader("{\n \"conversion_type_id\": \"123e4567-e89b-12d3-a456-426614174100\",\n \"lead_id\": \"123e4567-e89b-12d3-a456-426614174200\",\n \"amount\": 85000,\n \"workflow_run_id\": \"123e4567-e89b-12d3-a456-426614174400\",\n \"currency\": \"USD\",\n \"converted_at\": \"2026-02-01T15:30:00Z\",\n \"metadata\": {\n \"property_unit\": \"Apt 302\",\n \"broker\": \"John Smith\",\n \"external_deal_id\": \"DEAL-1234\"\n },\n \"notes\": \"Client paid in cash, expedited closing.\",\n \"lead_email\": \"<string>\",\n \"lead_phone\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.getnexor.ai/api/public/conversions")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"conversion_type_id\": \"123e4567-e89b-12d3-a456-426614174100\",\n \"lead_id\": \"123e4567-e89b-12d3-a456-426614174200\",\n \"amount\": 85000,\n \"workflow_run_id\": \"123e4567-e89b-12d3-a456-426614174400\",\n \"currency\": \"USD\",\n \"converted_at\": \"2026-02-01T15:30:00Z\",\n \"metadata\": {\n \"property_unit\": \"Apt 302\",\n \"broker\": \"John Smith\",\n \"external_deal_id\": \"DEAL-1234\"\n },\n \"notes\": \"Client paid in cash, expedited closing.\",\n \"lead_email\": \"<string>\",\n \"lead_phone\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getnexor.ai/api/public/conversions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"conversion_type_id\": \"123e4567-e89b-12d3-a456-426614174100\",\n \"lead_id\": \"123e4567-e89b-12d3-a456-426614174200\",\n \"amount\": 85000,\n \"workflow_run_id\": \"123e4567-e89b-12d3-a456-426614174400\",\n \"currency\": \"USD\",\n \"converted_at\": \"2026-02-01T15:30:00Z\",\n \"metadata\": {\n \"property_unit\": \"Apt 302\",\n \"broker\": \"John Smith\",\n \"external_deal_id\": \"DEAL-1234\"\n },\n \"notes\": \"Client paid in cash, expedited closing.\",\n \"lead_email\": \"<string>\",\n \"lead_phone\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"conversion_event": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversion_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": 123,
"currency": "<string>",
"converted_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"master_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"metadata": {},
"notes": "<string>",
"conversion_types": {
"name": "<string>",
"category": "intermediary",
"fields": [
{
"key": "property_unit",
"label": "Property / Unit",
"type": "text"
}
]
}
}
}Authorizations
API key for authentication. Keys are prefixed with nxr_live_.
Body
application/json
- Option 1
- Option 2
- Option 3
Create a conversion event. The workflow_id, master_workflow_id, and currency are automatically inherited from the conversion type — you typically do not need to provide them.
Conversion type ID. Use GET /conversion-types to list available types. The type's scope (workflow or master workflow) is automatically applied to the event.
Example:
"123e4567-e89b-12d3-a456-426614174100"
Lead ID that converted
Example:
"123e4567-e89b-12d3-a456-426614174200"
Monetary value of the conversion
Example:
85000
Optional workflow run ID for granular attribution to a specific run.
Example:
"123e4567-e89b-12d3-a456-426614174400"
Three-character currency override. Defaults to the conversion type currency, then USD.
Required string length:
3Example:
"USD"
Conversion time; defaults to the current time.
Example:
"2026-02-01T15:30:00Z"
Key-value data for this conversion event. Keys should match the fields[].key values defined on the conversion type (use GET /conversion-types to see each type's field definitions). You may also include arbitrary extra keys for external system data.
Example:
{
"property_unit": "Apt 302",
"broker": "John Smith",
"external_deal_id": "DEAL-1234"
}
Free-text notes about this conversion event
Example:
"Client paid in cash, expedited closing."
Last modified on September 8, 2026
⌘I