Dynamic Content Variation Object

Dynamic content personalizes parts of your website based on what you know about a viewer. Variations are the blocks of content that are displayed to prospects dynamically, based on criteria. Learn more about dynamic content in Salesforce Help.

The API to access the dynamic content variation object follows the conventions described in Version 5 Overview.

Operation	HTTP Verb	URL Format	Ability Requirements
Read	`GET`	`https://pi.pardot.com/api/v5/objects/dynamic-content-variations/<id>?<params>`	Content > Dynamic Content > View ability
Query	`GET`	`https://pi.pardot.com/api/v5/objects/dynamic-content-variations?<params>`	Content > Dynamic Content > View ability
Create	`POST`	`https://pi.pardot.com/api/v5/objects/dynamic-content-variations?<params>`	Content > Dynamic Content > Create ability

Field	Type	Description
`dynamicContentId`	Integer	ID of the dynamic content this variation is associated with.
`operator`	Enum	The operator found in the logic used to set the criteria for a variation. See Operator Enums below.
`value1`	String	The value found in the logic used to set the criteria for a variation. All operators except `between` require one value.

Field	Type	Description
`content`	String	The text content of the variation.
`value2`	String	The value found in the logic used to set the criteria for a variation when using the `between` operator. All other operators don't support two values.

Field	Type	Description
`id`	Integer	Account Engagement ID for this dynamic content variation.
`comparison`	String	The logic used to set the criteria for a variation. This field works together with the Dynamic Content `basedOn` field to determine which variation a prospect is served.
`dynamicContent`	Dynamic Content	The dynamic content the variation is associated with.

Retrieve a single dynamic content variation following the conventions described in the Version 5 Overview.

Example Request

Example Response

Retrieve a collection of dynamic content variations following the conventions described in the Version 5 Overview.

id

When executing a query, the following parameters can be used to filter the returned results. These parameters can be specified in the request along with any shared parameters defined in Version 5 Overview. When specifying more than one parameter, all parameters must match the record in order for it to be returned in the results.

Parameter	Description
`id`	Returns any dynamic content variation where ID is equal to the given integer value.
`idList`	Returns any dynamic content variation where ID is included in the given list of values.
`idGreaterThan`	Returns any dynamic content variation where ID is greater than the specified value, non-inclusive.
`idGreaterThanOrEqualTo`	Returns any dynamic content variation where ID is greater than or equal to the specified value.
`idLessThan`	Returns any dynamic content variation where ID is less than the specified value, non-inclusive.
`idLessThanOrEqualTo`	Returns any dynamic content variation where ID is less than or equal to the specified value.
`dynamicContentId`	Returns any dynamic content variation whose dynamic content ID is equal to the given integer value.
`dynamicContentIdGreaterThan`	Returns any dynamic content variation where ID is greater than the specified value, non-inclusive.
`dynamicContentIdGreaterThanOrEqualTo`	Returns any dynamic content variation where ID is greater than or equal to the specified value.
`dynamicContentIdLessThan`	Returns any dynamic content variation where ID is less than the specified value, non-inclusive.
`dynamicContentIdLessThanOrEqualTo`	Returns any dynamic content variation where ID is less than or equal to the specified value.

Example Request

Example response:

Create a single dynamic content variation following the conventions described in the Version 5 Overview.

Example request:

Example response:

The object supports these enums.

is
contains
between
less-than
less-than-or-equal
greater-than
greater-than-or-equal