Skip to main content

Klaviyo Identify

The Identify API is used to save information about a user without needing to track an event.

Data to Identify/Save​

If any of the following data is new or has changed, be sure to send it with an Identify API call (or include as part of customer_properties if using the Track API):

note

Any fields with $ in front are special fields within Klaviyo that have some extra functionality. Any other fields are allowed to be passed and are custom and don't have $ prepended.

  • User Info
    • $email
    • $first_name
    • $last_name
    • $phone_number
    • $city
    • $region
    • $country
    • $zip
    • $image
    • $consent: list of strings; eg: ['sms', 'email', 'web', 'directmail', 'mobile']
    • birthdate
    • gender
  • Final Wishes
    • plan completion status
      • fwCompletedPlanning
    • experience preferences
      • experienceStyle
      • experienceCategory
      • experiencePackageId
      • experienceInvitedType
      • experienceVibe
      • experienceDonations
      • experienceCelebrationType
      • experienceCelebrationSpecific
    • venue preferences
      • venueServicesName
      • venueServicesAddressStreet1
      • venueServicesAddressCity
      • venueServicesAddressState
      • venueServicesAddressZip
      • venueServicesSomewhereElse
      • venueServicesMyFamilyCanDecide
      • venueServicesTheFuneralHome
      • venueServicesSkip
      • venueAfterServicesName
      • venueAfterServicesAddressStreet1
      • venueAfterServicesAddressCity
      • venueAfterServicesAddressState
      • venueAfterServicesAddressZip
      • venueAfterServicesMyFamilyCanDecide
      • venueAfterServicesSkip
    • funeral home location
      • funeralHome
      • funeralHomeCity
      • funeralHomeState
      • funeralHomeSkipped
    • disposition preference
      • dispositionStyle
      • dispositionLocation
      • dispositionLocationSkip
      • dispositionLocationName
      • dispositionLocationAddress
      • dispositionLocationAddressStreet1
      • dispositionLocationAddressCity
      • dispositionLocationAddressState
      • dispositionLocationAddressZip
      • dispositionLocationMyFamilyCanDecide
      • dispositionLocationKeepItInAnUrn
      • dispositionPlotSkip
      • dispositionPlotPurchased
  • Health & Care
    • Plan completion status
      • hcCompletedPlanning
    • Weather preferences
      • climateValue
    • Surroundings preferences
      • surroundingsValue
    • Hobbies
      • hobbies
      • customHobbies
    • Travel preferences
      • travelValue
    • Food & Drink preferences
      • food
      • customFood
    • R&R preferences
      • rest
      • customRest
  • SLI
    • Plan completion status
      • sliCompletedPlan
    • Application status
      • SLIOrderId
    • birthdate
    • gender
    • coverage amount
      • selectedSLIPrice
      • monthlyRate
    • address
      • city
      • state
      • zip

Examples​

{
    "token": "PUBLIC_KEY",
    "properties": {
      // make sure to include at least $email or $phone_number to be able to identify the user
      "$email": user.email,
      "$first_name": user.name.first,
      "$last_name": user.name.last,
      "$city": user.address.city,
      "$region":user.address.state
    }
}