Klaviyo icon

Klaviyo

Interact with the Klaviyo API
Join our community

Actions17

Overview

The node allows updating a user profile in Klaviyo by specifying the profile ID and modifying its attributes. This is useful for keeping customer data up-to-date, such as changing contact information, location details, or custom properties. For example, you can update a user's email, phone number, or address after they submit a form or when syncing data from another system.

Properties

Name Meaning
Profile ID The unique identifier of the profile to update.
Attributes A collection of key-value pairs representing profile attributes to update. Keys include standard fields like email, phone_number, first_name, last_name, organization, locale, title, image, timestamps (created, updated, last_event_date), and nested location fields such as location.address1, location.city, location.country, etc.
Properties Additional custom key-value pairs to set on the profile beyond the predefined attribute keys.

Output

The node outputs JSON data representing the updated profile object returned by the Klaviyo API. The structure includes the profile's type (always "profile"), the id of the profile, and an attributes object containing all updated fields and properties. There is no binary output.

Example output JSON snippet:

{
  "data": {
    "type": "profile",
    "id": "profile_id_value",
    "attributes": {
      "email": "new_email@example.com",
      "first_name": "John",
      "properties": {
        "custom_key": "custom_value"
      }
    }
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Klaviyo API.
  • The node sends requests to the base URL: https://a.klaviyo.com/api.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Invalid Profile ID: If the provided Profile ID does not exist, the API will return an error. Verify the ID is correct.
  • Missing Required Fields: The Profile ID is mandatory; ensure it is provided.
  • API Authentication Errors: Check that the API key credential is valid and has sufficient permissions.
  • Invalid Attribute Keys: Using unsupported attribute keys may cause the update to fail or be ignored. Use only supported keys listed in the properties.
  • Network Issues: Ensure connectivity to the Klaviyo API endpoint.

Links and References

Discussion