Send wishlist item added signals with the API

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

Triggered when a visitor adds a product to their wishlist.

mutation {
  createSignals(
    signals: [
      {
        appKey: "{YOUR_APP_KEY}"
        identifiableAttributes: { contactKey: "AAUN-132417508" }
        sessionId: "SESS-789456123AB"
        signalContent: {
          signalType: "wishlistItemAdded"
          category: "Behavior"
          name: "Add product to wishlist in online store"
          effect: "positive"
          currency: "USD"
          productId: "SKU-98234"
          productName: "Women's Running Shoe"
          productCategory: "Footwear"
          price: 89.99
          wishlistId: "wl-001"
        }
      }
    ]
  ) {
    signalIds
  }
}

Required fields

• productId: String – Product identifier (may match SKU)
• signalType: String – Signal type (valid value: wishlistItemAdded)

Optional fields

• category: String – Signal category (valid value: Behavior)
• currency: String – Price currency. Valid values: ISO 4217 currency codes. Examples: "USD", "EUR", "GBP".
• description: String – Description of the signal
• effect: String – Signal engagement effect. Valid values: negative, positive. Use positive for all wishlist item added signals.
• externalVariantId: String – Identifies the specific size, color, or variant of the product that was saved
• name: String – Signal name to differentiate from other signals. Max length: 256 chars.
• price: Number – Price of the product at the time it was saved
• productCategory: String – Product category name based on catalog
• productName: String – Product name
• signalTimestamp: Date – When the signal happened (if omitted, Connect uses the time the signal was received). Valid values: DateTime strings (ISO 8601). Example: 2026-07-22T16:22:15.001Z.
• wishlistId: String – Identifies which wishlist or saved list the item was added to