Conversions

Create website conversion action

Creates a WEBPAGE conversion action (category DEFAULT) and returns it with its tag snippets, read back after creation since Google never returns them on the create response itself. Invalidates the cached list GET on this resource would otherwise keep serving. Google-only; other platforms return 501. Requires the Ads add-on.

post/v1/ads/conversions/actions

Request body

accountIdstring required

SocialAccount ID. Must be a googleads account.

customerIdstring

Google Ads customer id (digits only). Resolved automatically when the connection has exactly one accessible customer.

namestring required
type'WEBPAGE' required

Only WEBPAGE is supported for creation today.

defaultValuenumber

Default conversion value used when an event doesn't carry its own value.

alwaysUseDefaultValueboolean

When true, always use defaultValue and ignore any value sent with the event. Defaults to true when defaultValue is set.

Response

The created conversion action, with its tag snippets.

Changes