Inputs
SelectItem
Output
Type:Dict
Returns the accepted event count.
Fields: pixel_id, event_count, test_modeDocumentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Sends server-side conversion events to a Reddit Pixel (Reddit’s Conversions API) for attribution and optimization, with optional test mode
| App | Reddit Ads |
| Operation ID | reddit_ads_post_conversion_events |
| Type | Action |
| Connection | reddit_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
pixel_id | string or SelectItem | Yes | - | ID of the Reddit Pixel to post the conversion events to. Find pixel IDs with reddit_ads_list_pixels. |
events | array of object or string | Yes | - | Official Reddit Ads v3 conversion event objects as a JSON list, sent as-is. Each event requires event_at (Unix epoch milliseconds), action_source (WEBSITE, APP, OTHER, or PHYSICAL_STORE), and type with tracking_type (PAGE_VISIT, VIEW_CONTENT, SEARCH, ADD_TO_CART, ADD_TO_WISHLIST, PURCHASE, LEAD, SIGN_UP, or CUSTOM with custom_event_name). Optional: click_id (recommended for attribution), event_source_url, metadata (conversion_id for deduplication, currency, value, item_count, products), and user match keys (email, phone_number, external_id, ip_address, user_agent, aaid, idfa, uuid). Example: [{“event_at”: 1753900000000, “action_source”: “WEBSITE”, “type”: {“tracking_type”: “PURCHASE”}, “metadata”: {“conversion_id”: “order-123”, “currency”: “USD”, “value”: 49.99}, “user”: {“email”: “user@example.com”, “ip_address”: “203.0.113.7”}}] |
test_id | string | No | - | Optional test ID from the Reddit Events Manager testing tool; when set, events are treated as test events. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
Dict
Returns the accepted event count.
Fields: pixel_id, event_count, test_mode