Create Conversion Event - Markifact

Create an OpenAI Ads conversion event setting connected to one conversion source (pixel). Standard events like order_created can then be used as oCPC optimization goals via conversion_event_setting_ids on campaign creation; custom events are reporting-only.


App	OpenAI Ads
Operation ID	`openai_ads_create_conversion_event`
Type	Action
Connection	`openai_ads` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`name`	string	Yes	-	Display name for the conversion event setting.
`event_type`	string or SelectableOption	Yes	-	Conversion event type. Standard events (e.g. ‘order_created’, ‘lead_created’) can be used as oCPC optimization goals; ‘custom’ events cannot and need a custom_event_name.
`custom_event_name`	string	No	-	Name of the custom event. Required when event_type is ‘custom’.
`source_id`	string or SelectableOption	Yes	-	Exactly one conversion source ID to connect (the cds_/clidsrc_ `id` from openai_ads_list_pixels or openai_ads_create_pixel, not the pixel_id).

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the created event setting exactly as returned by the OpenAI Ads API (id, name, event_type, custom_event_name, attribution_window_days, source_ids, sources, campaigns, archived, version). Fields: dynamic (depend on the inputs) Example:

{
  "id": "ces_...",
  "name": "Purchases",
  "event_type": "order_created",
  "attribution_window_days": 30,
  "source_ids": [
    "cds_..."
  ]
}