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

201Conversion event created successfully

400Invalid request

401Unauthorized

422Unprocessable entity

429Rate limit exceeded

500Internal server error