marketingEngagementCreate mutation

Version unstable

Creates a new marketing event engagement for a marketing activity.

Required access

write_marketing_events access scope. Also: App must have access to the marketing activity.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Argument Description
marketingActivityId ( ID! ) required

The id of marketing activity.

marketingEngagement ( MarketingEngagementInput! ) required

The marketing engagement's attributes.

MarketingEngagementInput fields

  • adSpend (MoneyInput)

    The total ad spend for the day, if the marketing event is a paid ad with a daily spend.

  • clicksCount (Int)

    The total number of clicks on the marketing event for the day.

  • commentsCount (Int)

    The total number of comments for the day.

  • complaintsCount (Int)

    The total number of complaints for the day.

  • failsCount (Int)

    The total number of fails for the day.

  • favoritesCount (Int)

    The total number of favorites for the day.

  • fetchedAt (DateTime)

    The date time at which the data was fetched.

  • impressionsCount (Int)

    The total number of impressions for the day.

  • isCumulative (Boolean)

    Whether the engagements are reported as lifetime values rather than daily totals.

  • occurredOn (Date!) Required

    The date that these engagements occurred on.

  • sendsCount (Int)

    The total number of sends for the day.

  • sharesCount (Int)