Send page view signals with the API

Send a page view signal to Connect with the createSignals mutation. For authentication, contact mapping, consent and the response, see Send signals with the API (GraphQL).

Registers page views as users browse your website.

mutation {
  createSignals(
    signals: [
      {
        appKey: "{YOUR_APP_KEY}"
        sessionId: "SESS-789456123AB"
        audience: [
          { name: "Customer ID", value: "AAUN-1417508" }
          { name: "Email", value: "[email protected]" }
        ]
        signalContent: {
          signalType: "pageView"
          category: "Behavior"
          name: "Page view from online store"
          effect: "positive"
          url: "https://www.example.com/painting-and-decorating/tools/"
          pageCategory: "Painting & Decorating"
          pageGroup: "Product Categories"
          signalTimestamp: "2026-02-22T08:29:30.001Z"
        }
      }
    ]
  ) {
    signalIds
  }
}

Required fields

• signalType: String - Signal type (valid value: pageView)
• url: String - URL of page user opened

Optional fields

• category: String - Signal category (valid values: Behavior)
• description: String - Description of the signal.
• effect: String - Signal interpretation for engagement index scoring. Valid values: negative, positive.
• name: String (up to 256 characters) - Signal name to differentiate from other signals
• pageCategory: String - Category the page belongs to
• pageGroup: String - A grouping for related pages
• pageTitle: String - Title of the page the user opened
• signalCustomAttributes: Array of objects - Additional custom attributes (each object needs name and value string fields)
• signalTimestamp: Date - When signal happened (if omitted, Connect uses time when signal was received). Valid values: DateTime strings (ISO 8601). Example: 2026-02-28T16:22:15.001Z.