Distribute Workflow Records with Percentage Splits

Using Percentage-Based branching to manage large enrollments in HubSpot workflows

When using Integration Glue micro apps inside HubSpot workflows, it’s important to manage how many records flow through at once. HubSpot workflows can process a large number of records at once. If too many actions are triggered simultaneously, HubSpot’s workflow action rate limits may be reached. This can cause delays, throttling, or failures in connected processes, including when using Integration Glue micro apps inside workflows.

To prevent this when enrolling large batches, you can use HubSpot’s percentage-based branch splits combined with time delays. This helps distribute records evenly and reduce sudden load spikes.

Why use percentage-based branching?

  • Stay within HubSpot’s rate limits: Avoid hitting the maximum number of workflow actions HubSpot can process per second/minute.

  • Distribute workload: Split records into smaller groups that process independently.

  • Smooth processing: Add delays between branches so records flow through gradually instead of in one large burst.

  • Increase reliability: Reduces the risk of HubSpot throttling workflow actions.

How to set up a percentage-based branch

  1. In your HubSpot workflow, add an Action.

  2. Select Branch → Random distribution (percentage split).

  3. Choose how many branches to use (e.g., 2, 3, or more), and save the Action.

    • Example (two-way split):

      • Branch 1: 50%

      • Branch 2: 50%

    • Example (three-way split):

      • Branch 1: 33%

      • Branch 2: 33%

      • Branch 3: 33%

  4. Add a new Action. Select BranchDelay → Set Amount of Time.
  5. Space the time delays out over your percentage branches and save the Action.
  6. Add your workflow actions (e.g., micro app triggers) under each branch.