Create, Update, and Get User from Iterable

Overview

This workflow demonstrates how to manage user profiles in Iterable by performing three sequential operations: creating a user, updating their data fields, and retrieving the updated record. It's a practical example of Iterable's user lifecycle management, useful for marketing teams who need to synchronize customer data from other systems into Iterable for targeted campaigns.

Workflow Steps

1. On clicking 'execute' (Manual Trigger) — Starts the workflow when the user clicks the 'Execute Workflow' button in the n8n editor. No authentication required.

2. Iterable (Create User) — Creates a new user in Iterable using an email address as the identifier. The node is configured with:

   • value: The email address of the user to create (entered manually or via expression)
   • identifier: Set to "email" to use email as the unique identifier
   • additionalFields: Empty (no extra fields on creation)
   • Authentication: Requires Iterable API Key (set in n8n credentials)

3. Iterable1 (Update User) — Updates the user created in the previous step by adding a custom data field. Configuration:

   • value: Dynamically references the email from the first Iterable node using ={{$node["Iterable"].parameter["value"]}}
   • identifier: "email"
   • additionalFields.dataFieldsUi.dataFieldValues: Adds a field with key "Name" and an empty value (user should populate this)
   • Authentication: Same Iterable API Key credential

4. Iterable2 (Get User) — Retrieves the updated user profile to confirm the changes. Configuration:

   • email: References the same email from the first node via expression
   • operation: Set to "get" to fetch user details
   • Authentication: Same Iterable API Key credential

Setup Instructions

1. Iterable Account: You need an active Iterable account with API access. Generate an API key from Iterable's Settings > API Keys page.
2. n8n Credentials: In n8n, create a new "Iterable API" credential and paste your API key.
3. Email Value: Before running, replace the value parameter in the first Iterable node with a valid email address (or use an expression to pass it dynamically).
4. Optional: In the Iterable1 node, set the "Name" field value to an actual name (e.g., "John Doe") to see the update in action.

Use Cases & Variations

• User Onboarding: Automatically create and enrich user profiles when someone signs up via a form or API.
• Data Sync: Combine with a Schedule Trigger to periodically sync user data from a CRM or database into Iterable.
• Error Handling: Add error-handling nodes (e.g., IF node) to check if the user already exists before creating.
• Bulk Operations: Use a SplitInBatches node to process multiple users from a CSV or Google Sheet.
• Event Tracking: Extend the workflow to log events (e.g., "User Created") in Iterable after the update.

{
  "id": "165",
  "name": "Create, update and get a user from Iterable",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        310,
        340
      ],
      "parameters": {},
      "typeVersion": 1
    },
    {
      "name": "Iterable",
      "type": "n8n-nodes-base.iterable",
      "position": [
        510,
        340
      ],
      "parameters": {
        "value": "",
        "identifier": "email",
        "additionalFields": {}
      },
      "credentials": {
        "iterableApi": "Iterable"
      },
      "typeVersion": 1
    },
    {
      "name": "Iterable1",
      "type": "n8n-nodes-base.iterable",
      "position": [
        710,
        340
      ],
      "parameters": {
        "value": "={{$node[\"Iterable\"].parameter[\"value\"]}}",
        "identifier": "email",
        "additionalFields": {
          "dataFieldsUi": {
            "dataFieldValues": [
              {
                "key": "Name",
                "value": ""
              }
            ]
          }
// ... truncated (copy to see full JSON)