Klaviyo Integration

ValueMapper supports Klaviyo for promotion synchronization, lifecycle events, and redemption code sync.

What ValueMapper does in Klaviyo

When Klaviyo is connected, ValueMapper uses Klaviyo APIs for:

• Coupons: Creates a Klaviyo Coupon when a promotion is created, and updates the Coupon when promotion details change.
• Coupon codes: Syncs ValueMapper redemption codes to Klaviyo through bulk coupon-code jobs tied to the promotion's Klaviyo coupon.
• Profiles: Creates or updates Klaviyo profiles from ValueMapper contacts, and stores the Klaviyo profile ID for future sync/event operations.
• Events: Sends ValueMapper Coupon Assigned, ValueMapper Coupon Redeemed, and lifecycle event metrics for downstream flows/segments.

How to get Klaviyo added

1. Open ValueMapper and go to Connected Services.
2. Select Klaviyo.
3. Generate a Klaviyo private API key in your Klaviyo account: Create private API key.
4. Ensure the key has access to:
   • Accounts (read)
   • Coupons (read/write)
   • Coupon Codes (write)
   • Profiles (read/write)
   • Events (write)
5. Add Klaviyo as a connected service using addConnectedService.

mutation AddKlaviyoService {
  addConnectedService(
    connectedService: {
      serviceType: KLAVIYO
      token: "<KLAVIYO_PRIVATE_API_KEY>"
    }
  ) {
    success
    errors
  }
}

Notes

• Promotions synced to Klaviyo are represented as Klaviyo Coupons and referenced by destination-level external IDs.
• Contact creation and contact updates in ValueMapper trigger Klaviyo profile upsert behavior.
• Redemption code issuance syncs codes to the resolved Klaviyo coupon, not just to the primary connected service.

Verify setup

After adding the service, query your connected services:

query ConnectedServices {
  account {
    connectedServices(enabled: true) {
      name
      serviceType
      enabled
      roles
      metadata {
        ... on KlaviyoServiceMetadata {
          tokenConfigured
        }
      }
    }
  }
}