Assigning errors in integrator.io lets you delegate troubleshooting to specific team members to resolve flow issues quickly. This task-oriented workflow helps you route errors to subject matter experts, prioritize work using tags, and track resolution progress through automated notifications. Managing flow errors effectively requires a coordinated approach between monitoring, organization, and delegation. After you investigate and resolve flow errors to identify the root cause, use error assignment to route specific issues to the right team members. By combining assignment with the ability to use tags to organize errors, you create a searchable, prioritized backlog that ensures critical blockers are addressed first. To get started, ensure your team has the correct setup by managing integration users and permissions, which defines who can view, assign, and receive notifications for these tasks.
This article focuses on point 4 in the error management workflow below.
The following diagram represents the logical path from error detection to resolution. Use this flow to ensure errors are handled by the correct team members in a timely manner.
| Stage | What to do | Where to do |
|---|---|---|
| Monitor | Check for errors after flow runs | Dashboard / Flow builder |
| Notify | Get notified of errors only when you or your admin have subscribed to the notification mails. (However, get automatically notified when errors are assigned. | Integration page/Flow settings |
| Organize | Label errors using tags, for example, apply priority or contextual tags. | Errors page |
| Delegate | Assign errors to yourself/team for ownership, follow up, and resolution. | Errors page |
| Investigate | Review Error list/details (and other locations listed here) to identify the root cause of errors. | Errors page / Flow builder / Advanced flow editors |
| Resolve | Correct and retry any assigned errors for resolution/closure. | Errors page |
The example workflow merely indicates how errors could move from occurrence to resolution, but you can order the steps based on your scenario.
- Subscription plan: Standard, Professional, or Enterprise edition.
-
Permissions:
- Admins and Owners: Full access to assign errors and invite users.
- Non-admins: Can assign errors to existing users. You can only invite new users if the Invitations feature is turned on in your account settings.
-
Access: You must have at least
Monitoraccess to the specific integration.
The following table defines which roles can perform assignment and invitation actions:
If a colleague is not currently a user in the integration, use one of the following methods to add them:
- Simultaneous assignment: In the Errors list, select your errors and enter the new user's email. The system sends an invitation and the error notification at the same time.
-
Manual invitation: Add the user via the Users tab before assigning errors.
- Navigation: Integration > Users > Invite user
Follow these steps to delegate one or more open errors:
- Go to the Open errors list for the specific flow step.
- Select the checkbox for the errors you want to delegate.
-
Choose an assignment option:
- Single error: Select Assign errors in the specific row.
- Multiple errors: Select the checkbox next to the errors and then select Assign errors at the top of the list.
- Select a name from the list or enter a new email address in the Assign to new user field.
- Select Assign.
Tip
To remove an assignment, select the assignee's name and select Clear assignment.
The platform manages notifications to ensure users stay informed without receiving excessive emails:
- Wait period: The platform waits 15 minutes after the first assignment before sending an email. Any other errors assigned to that user during this window are bundled into one notification.
- Batch limit: Each email contains a maximum of 25 errors.
- Acceptance: New users must accept their invitation and sign in before they can view assigned errors.
Tip
Self-assignment: The platform does not send notifications if you assign an error to yourself.
Error notifications vs Error assignment notifications: Error notifications in an integration are sent only when you or your account owner/admin configure them for specifc flows, but assignment notifications are automatically sent when an error is assigned.
You can filter the error list to manage specific workloads or track progress.
- In the Errors list, select the Filter icon.
- Select the checkbox for specific users or Tags.
- Select Apply.
The platform uses identifiers to automatically route recurring errors to the same user.
| Identifier type | Assignment behavior |
|---|---|
| Retry data key | Automatically assigns all matching open errors to the same user. |
| Trace key | Assigns new occurrences to the same user if the Auto-resolve errors with matching trace key option is turned on in flow settings. |