---
title: "Conversão via API Key"
method: POST
path: "/platform/conversions"
---

# Conversão via API Key

`POST /platform/conversions`

O evento de conversão pode ser utilizado para **criar e atualizar** contatos na Base de Leads.
O RD Station Marketing considera o valor do atributo `conversion_identifier` como identificador da conversão.  
Esse evento é registrado sempre que ocorre uma conversão.

## Query parameters

- `api_key` string, required

## Headers

- `Content-Type` string, required

## Request body

- object
  - `event_type` string, required — O tipo de evento que diferencia o evento. Para o evento de conversão deve ser enviado como "CONVERSION".
  - `event_family` string, required — A família do evento para fins de processamento. Atualmente aceita apenas "CDP" como opção válida.
  - `payload` object, required
    - `conversion_identifier` string, required — O nome do evento de conversão
    - `email` string, required — Email do contato (Obrigatório se o phone não for enviado)
    - `phone` string, required — Telefone do contato (Obrigatório se o email não for enviado)
    - `name` string — Nome do contato
    - `job_title` string — Cargo do contato
    - `state` string — Estado do contato
    - `city` string — Cidade do contato
    - `country` string — País do contato
    - `personal_phone` string — Telefone do contato.
    - `mobile_phone` string — Celular do contato
    - `twitter` string — Twitter do contato
    - `facebook` string — Facebook do contato
    - `linkedin` string — Linkedin do contato
    - `website` string — Site do contato.
    - `company_name` string — Nome da empresa do contato
    - `company_site` string — Site da empresa do contato
    - `company_address` string — Endereço da empresa do contato
    - `client_tracking_id` string — Valor de um cookie '_rdtrk'. (por exemplo: 43b00843-09af-4fae-bf9d-a0697640b808)
    - `traffic_source` string — Isso pode ser o valor de um cookie '__trf.src' (codificado em base 64 ou não) ou um parâmetro de origem UTM. Se passar um cookie, os seguintes campos DEVEM estar vazios: traffic_medium, traffic_campaign e traffic_value
    - `traffic_medium` string — UTM medium
    - `traffic_campaign` string — UTM campaig
    - `traffic_value` string — UTM value (term)
    - `available_for_mailing` boolean — Ative/desative o recebimento de e-mails
    - `tags` string[] — Tags que podem ser adicionadas ao contato
    - `legal_bases` object[] — Bases Legais do contato
      - `category` string
      - `type` string
      - `status` string
    - `cf_custom_field_name` string — Campo personalizado criado no RD Station Marketing e seu valor relacionado ao contato. Todos os campos personalizados disponíveis na conta do RD Station Marketing são válidos neste payload; você pode enviar quantos campos desejar. Devem ser enviados com o prefixo "cf_" e o nome do campo (sem espaços). Por exemplo: cf_assunto_de_interesse

## Response `200`

200

- object
  - `event_uuid` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/versions/3867c21388e8/schema)