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).

To learn what this signal captures and how to use it in Connect, see Wishlist item added signal guide. To send it from your website or app instead, use Log signal: web, Android, iOS.

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