Pixels

Send test conversion events to a pixel

Sends live Meta Conversions API events named Soundlink Auth, Soundlink Stream, Soundlink Stream Value (value 0 USD), Soundlink Follower, and Soundlink Artist Follower to pixelId in one request with its stored access token. These are not sandbox events: they appear in the pixel’s Events Manager as regular events. This request has no body.

Returns 404 not_found when the pixel is not configured for the organization. Returns 400 invalid_request when Meta rejects the event because the pixel id or access token is wrong. Does not require Idempotency-Key; each call sends a new event.

Requires pixels:write. Organizations without custom pixels enabled get 403 custom_pixel_not_enabled.

Auth: Accepts API key or OAuth Bearer (pixels:write).

POST

pixels

{pixelId}

test-events

Send test conversion events to a pixel

curl --request POST \
  --url https://api.getsoundlink.com/v1/pixels/{pixelId}/test-events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.getsoundlink.com/v1/pixels/{pixelId}/test-events"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/pixels/{pixelId}/test-events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "status": "sent",
    "pixelId": "1234567890123456"
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Authorizations

Authorization

string

header

required

Pass your Soundlink sk_* API key as a Bearer token: Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see oauthBearer for that). Accepted on all Public API operations. Send only one Authorization header per request.

Path Parameters

pixelId

string

required

Pixel id on the ad platform.

Minimum string length: 1

Response

Test event sent

data

object

required

Show child attributes

meta

object

required

Show child attributes

Send test conversion events to a pixel

curl --request POST \
  --url https://api.getsoundlink.com/v1/pixels/{pixelId}/test-events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.getsoundlink.com/v1/pixels/{pixelId}/test-events"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/pixels/{pixelId}/test-events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "status": "sent",
    "pixelId": "1234567890123456"
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

System

Wallet

Campaigns

Soundlinks

Videos

Pixels

Send test conversion events to a pixel

Authorizations

Path Parameters

Response