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

# Conversão via API Key

`POST /platform/conversions`

## Request

- Base URL: `https://api.rd.services`
- URL: `https://api.rd.services/platform/conversions`
- Auth: none required

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.dev/rdstation/apis/rd-station-marketing-api.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-marketing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-marketing-api/revisions/3c3df77f4eef?raw)