Skip to content
Tallyraydocs

Send the connection's source a conversion made up for the test, as its template marks one (Meta's and TikTok's test event code, Google's validate-only), and say how the source read it; never a delivery. 10 a minute and 100 a day for each connection

POST
/v1/buyer/connections/{id}/test-conversion
curl --request POST \
  --url https://example.com/v1/buyer/connections/example/test-conversion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "event": "lead", "external_click_id": "example", "external_click_param": "example", "value": { "amount_micros": 1, "currency": "example" } }'

Who: a workspace’s buyer, or its key. API keys with the buyer:write scope.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
event
required
string
Allowed values: lead registration sale deposit subscription rebill custom install reengagement
external_click_id
string
external_click_param
string
value
Any of:
object
amount_micros
required
integer format: int64
currency
required
string

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
call_id
required
string
conversion_id
required
string
message
required
string
ok
required
boolean
status
required
integer format: int32

Example generated

{
  "call_id": "example",
  "conversion_id": "example",
  "message": "example",
  "ok": true,
  "status": 1
}

default

Section titled “default”

An error, as go-commons apperr maps it

Media typeapplication/json
object
error
required
object
code
required
string
fields
object
key
additional properties
string
message
required
string

Example generated

{
  "error": {
    "code": "example",
    "fields": {
      "additionalProperty": "example"
    },
    "message": "example"
  }
}