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

Crear Evento de Conversión

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

Autorizaciones

X-API-Key

string

header

requerido

API key for authentication. Keys are prefixed with nxr_live_.

Cuerpo

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>

requerido

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.

Ejemplo:

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

lead_id

string<uuid>

requerido

Lead ID that converted

Ejemplo:

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

amount

number<double>

requerido

Monetary value of the conversion

Ejemplo:

85000

workflow_run_id

string<uuid> | null

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

Ejemplo:

"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

Ejemplo:

"USD"

converted_at

string<date-time>

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

Ejemplo:

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

Ejemplo:

{
  "property_unit": "Apt 302",
  "broker": "John Smith",
  "external_deal_id": "DEAL-1234"
}

notes

string | null

Free-text notes about this conversion event

Ejemplo:

"Client paid in cash, expedited closing."

Respuesta

Conversion event created successfully

success

boolean

requerido

Ejemplo:

true

conversion_event

object

requerido

Show child attributes

Última modificación el 18 de junio de 2026

Listar Tipos de Conversión

Listar Etiquetas