MAXIMUM_HIERARCHY_LEVELS_REACHED
This error occurs when a campaign hierarchy in Salesforce exceeds the maximum depth of five levels. MoveData creates campaigns automatically, and adding parent campaigns above MoveData's structure can push the hierarchy beyond this limit.
Error message#
You will see the following message in the execution log:
MAXIMUM_HIERARCHY_LEVELS_REACHED
For help locating this message, see Reading and understanding error messages.
Why this happens#
Salesforce allows a campaign hierarchy (a chain of parent-child campaigns) to be at most five levels deep. There is no limit on the number of campaigns — only on how many levels they can nest.
How MoveData uses campaign hierarchy#
MoveData typically uses up to three levels of campaign hierarchy, depending on the source platform:
| Level | Example |
|---|---|
| Level 1 — Campaign or Event | "2025 World Marathon" |
| Level 2 — Team Fundraising Page | "Team MoveData" |
| Level 3 — Individual Fundraising Page | "Joe Bloggs in Team MoveData" |
This three-level structure leaves room for two additional parent levels above it.
When the error occurs#
If you add parent campaigns above MoveData's top-level campaign, the total depth can exceed five levels. For example:
Level 1: All Fundraising (your campaign)
Level 2: 2025 Events (your campaign)
Level 3: Running Events (your campaign)
Level 4: 2025 World Marathon (MoveData — Campaign)
Level 5: Team MoveData (MoveData — Team)
Level 6: Joe Bloggs (MoveData — Individual) ← exceeds the 5-level limit
In this example, three parent campaigns you added above MoveData's structure push the hierarchy to six levels.
When MoveData tries to create the individual fundraiser campaign at level 6, Salesforce rejects it with the MAXIMUM_HIERARCHY_LEVELS_REACHED error.
How to fix it#
Option 1: Reduce the number of parent campaigns#
Review the parent campaigns above MoveData's top-level campaign. Remove or consolidate parent levels so the total hierarchy stays within five levels.
Option 2: Flatten unnecessary levels#
If you use parent campaigns for categorisation (such as "All Fundraising" or "2025 Events"), consider replacing hierarchy levels with custom fields on the campaign record. For example, use a Campaign Category or Year custom field instead of a dedicated parent campaign.
Option 3: Restructure the hierarchy#
Move MoveData's top-level campaigns directly under a single parent campaign, keeping the total depth to four or five levels:
Level 1: 2025 Events (your parent)
Level 2: 2025 World Marathon (MoveData Level 1)
Level 3: Team MoveData (MoveData Level 2)
Level 4: Joe Bloggs (MoveData Level 3)
After adjusting the hierarchy, reprocess the failed notification using the Reprocess button.