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
}
'

{
  "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>",
      "fields": [
        {
          "key": "property_unit",
          "label": "Property / Unit",
          "type": "text"
        }
      ]
    }
  }
}

Create Conversion Event

Record a conversion event for a lead. Conversions track business outcomes such as reservations (intermediary) or closed sales (final).

The workflow_id, master_workflow_id, and currency are automatically inherited from the conversion type, and converted_at defaults to the current time. You only need to provide conversion_type_id, lead_id, and amount. You may optionally provide converted_at, workflow_run_id, or override currency.

Each conversion type can define custom fields (see GET /conversion-types). When creating an event, pass the corresponding values in the metadata object using the field key as the JSON key. For example, if a conversion type has a field with key: "property_unit", include "property_unit": "Apt 302" in metadata.

POST

conversions

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
}
'

{
  "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>",
      "fields": [
        {
          "key": "property_unit",
          "label": "Property / Unit",
          "type": "text"
        }
      ]
    }
  }
}

Authorizations

X-API-Key

string

header

required

API key for authentication. Keys are prefixed with nxr_live_.

Body

application/json

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

string<uuid>

required

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

string<uuid>

required

Lead ID that converted

Example:

"123e4567-e89b-12d3-a456-426614174200"

amount

number<double>

required

Monetary value of the conversion

Example:

85000

workflow_run_id

string<uuid> | null

Optional workflow run ID for granular attribution to a specific run.

Example:

"123e4567-e89b-12d3-a456-426614174400"

currency

string

ISO 4217 currency code. Automatically inherited from the conversion type's currency setting — only provide this to override the default.

Required string length: 3

Example:

"USD"

converted_at

string<date-time>

When the conversion actually occurred (ISO 8601 timestamp). Defaults to the current time if not provided.

Example:

"2026-02-01T15:30:00Z"

metadata

object

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"
}

notes

string | null

Free-text notes about this conversion event

Example:

"Client paid in cash, expedited closing."

Response

Conversion event created successfully

success

boolean

required

Example:

true

conversion_event

object

required

Show child attributes

Last modified on June 18, 2026

Quick Start

WhatsApp

Agents

Assistant

Advanced

API Reference

Leads

Agents

Workflow Tools

Client Tools

Groups

Campaigns

Conversions

Reports

Tags

Messages

Background Jobs

Meetings

Team

Processors

Create Conversion Event

Authorizations

Body

Response