Create an attributed conversion event

post

https://t.vibe.co/conversions/events

Receives a pre-attributed conversion event from a partner

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

event_id

string

required

Unique identifier for the event

event_name

string

required

Name of the conversion event (e.g., purchase, lead, add_to_cart)

event_time

date-time

required

When the conversion occurred (ISO 8601)

advertiser_id

string

required

Vibe internal advertiser/tenant ID

source_partner

string

required

Partner sending the attributed event

value

number

Revenue value

currency

string

ISO 4217 currency code

order_id

string

Order/transaction identifier

attribution

object

required

Attribution result. At least one join key (campaign_id, adset_id, ad_id, or impression_id) is required.

touchpoints

array of objects

Conversion path touchpoints

touchpoints

customer_type

string

Whether the customer is new or returning

test_mode

boolean

Defaults to false

If true, event is processed but excluded from reporting

Responses

200

Event received and logged. The response body is empty

400Invalid request

401Unauthorized

422Unprocessable entity

429Rate limit exceeded

500Internal server error