Automate Stripe Charges Sync to HubSpot Contacts Using n8n

Beginner Step-by-Step: Usage in n8n

Step 1: Import Workflow

1. Download the workflow file using the Download button on this page.
2. Open the n8n editor (cloud or self-host n8n).
3. Click menu and select “Import from File”.
4. Choose the downloaded workflow file to import.

Step 2: Configure Credentials and Settings

1. Add API credentials for Stripe and HubSpot if not already present in n8n.
2. Open the Set (Configure) node and update contactPropertyId if needed.
3. If you use a different HubSpot field for total spend, update contactPropertyLabelName.

Step 3: Test the Workflow

1. Trigger the workflow manually with the schedule node by choosing “Execute Workflow Now.”
2. Observe the execution and check the output data for correctness.

Step 4: Activate for Production

1. Enable the scheduled trigger node to run automatically at your chosen interval.
2. Monitor initial runs from the n8n dashboard for any errors.

Common Edge Cases and Failures

• Missing HubSpot custom property causing 404 errors on fetch.
• Stripe charges with no linked customer ID are filtered out to avoid errors.
• HubSpot contact not updating due to bad email mappings or missing permissions.

const customerTotals = {};

for (const charge of items) {
  const email = charge.json.customer_email;
  const amount = charge.json.amount_captured / 100;

  if (!email) continue;

  if (!customerTotals[email]) {
    customerTotals[email] = 0;
  }

  customerTotals[email] += amount;
}

return Object.entries(customerTotals).map(([email, total]) => ({
  json: { email, total_spend: total }
}));