Manage and Troubleshoot Workflows

Article author
Updated

Overview

After you launch a workflow, you can update its configuration, manage enrolled records, review its performance, and retry records that encounter errors.

Use this article to manage an existing workflow, add people manually, review workflow runs and activity, resolve failed records, and control who can access or copy the workflow.

 
Permission to Proceed

Your permission profile determines which workflow actions you can complete. You need Can view workflows permission to access workflows and Can activate workflows permission to activate or deactivate them. If you can edit a workflow but can't activate it, submit the workflow to an admin for review.

Check out the following sections to manage and troubleshoot workflows.

Back to Top

Manage a Workflow

Keep your workflows up to date as your processes evolve. Use the following tabs to update workflow logic, control when a workflow runs, organize it for your team, and manage who can access or reuse it.

Edit a workflow when you need to change its trigger, filters, rules, actions, or settings.

To edit a workflow:

  1. Launch Apollo, then click Workflows.
  2. Select the workflow, then click Edit workflow.
  3. Click a workflow block to open its configuration panel.
  4. Update the trigger, filters, rules, or actions, then click Done. In the workflow builder, the highlighted Send webhook configuration panel shows the settings you can update before clicking Done.
  5. Repeat these steps for each block you want to update.
  6. Save or publish your changes:
    • For an inactive workflow, click Save and Launch workflow when you're ready to configure its launch options.
    • For an active workflow, click Publish changes.

You have now updated the workflow.

 
Reset Expectations

You can change the workflow target before the workflow completes its first run. Changing the target resets the workflow and removes its triggers, filters, rules, and actions. After the first run, the target is locked. You can still change the run type, but doing so clears the message in a Send Notifications action.

Activate a workflow when you're ready for Apollo to begin processing records. Deactivate it when you need to stop new records from entering while you review or update the workflow.

To activate or deactivate a workflow:

  1. Launch Apollo, then click Workflows.
  2. Select the workflow.
  3. Complete one of the following actions:
    • To start an inactive workflow:
      1. Click Launch workflow. In the Activate workflow window, review potential credit usage, update the workflow settings, or confirm activation.
      2. Review the workflow settings and potential credit usage. To change the enrollment settings, click Update settings.
      3. Click Confirm activation.
    • To stop an active workflow, switch the workflow off.
    • If you don't have permission to activate workflows, click Submit for approval.

You have now activated, deactivated, or submitted the workflow for approval.

Deactivating a workflow stops it from processing new records. It doesn't delete its configuration or previous runs.

Use the Actions menu to clone, move, archive, or restore a workflow.

To clone, move, or archive a saved workflow:

  1. Launch Apollo, then click Workflows.
  2. Locate the workflow you want to manage.
  3. Click Actions from the workflow row, overview page, or workflow builder. In the workflow builder, the highlighted ellipsis opens the Actions menu for the saved workflow.
  4. Select the action you want to complete:
    • Clone: Create a copy and open it in the workflow builder. You can't clone a pre-built workflow.
    • Move to folder: Select a folder, then click Move Here.
    • Archive: Click Archive in the confirmation window. Archiving an active workflow automatically switches it off.

You have now cloned, moved, or archived the workflow.

You can also select multiple workflows from the workflow list, then move or archive them in bulk.

To restore an archived workflow:

  1. Launch Apollo, then click Workflows.
  2. Click Filters > Workflow status > Archived.
  3. Select the archived workflow.
  4. Click Unarchive. You can also click Actions > Unarchive.

You have now restored the workflow. The workflow returns switched off, so review it before you launch it again.

Share a saved workflow when other members of your team need to view or manage it. You can also publish an eligible workflow as a public template that anyone with the link can view and clone.

Share a Workflow

To share a workflow:

  1. Launch Apollo, then click Workflows.
  2. Select the saved workflow.
  3. Click Actions > Share.
  4. Choose the workflow access:
    • Restricted: Only people with access can view the workflow.
    • Everyone at [team]: Everyone in your team can access the workflow.
  5. For restricted access, add the users who need access and choose their access level:
    • Full access: The user can edit the workflow and share it with others.
    • Can edit: The user can edit the workflow but can't share it.
    • Can view: The user can view the workflow but can't edit or share it.
  6. Click Done.

You have now shared the workflow.

 
Access Granted

Only users with Full access can change sharing. Admins and workflow owners have full access. A user's workflow permissions still apply after you share the workflow, and users may need to grant access to their contacts, accounts, and deals before they can edit it. Non-admin users can't access workflows created by admins, and person-level sharing only applies to workflows created by non-admin users.

If workflow sharing isn't included in your plan, Apollo displays Upgrade to share.

Publish a Workflow as a Public Template

The workflow must have completed at least one run before you can publish it as a public template. Draft workflows display Only published workflows can be shared.

To publish a workflow as a public template:

  1. Launch Apollo, then click Workflows.
  2. Select the workflow, then click Actions > Share.
  3. Click Publish.
  4. Toggle on Make workflow public as template.
  5. Enter a name in Template Name.
  6. Click Copy link to share the public template.

You have now published the workflow as a public template. The Published as template column on the workflow list displays Live.

Anyone with the link can view and clone the public template. Apollo hides private filters and fields, and edits to the original workflow update the shared version.

To stop sharing the public template, return to Share > Publish, then toggle off Make workflow public as template. Apollo displays Workflow template un-published, and the workflow list displays Unpublished.

 
Public, Not Pre-Built

Publishing a public template doesn't add it to Apollo's in-app template library. Customers can't add workflows to that library.

Back to Top

Add People to a Workflow Manually

You can manually add people to an active workflow without waiting for them to meet the workflow trigger.

 
Skip the Trigger

Manual enrollment bypasses the workflow trigger and starts the selected people at the configured workflow steps. Review the workflow before you manually add people to confirm that its actions are appropriate for them.

To manually add people:

  1. Launch Apollo, then click Prospect and enrich > People. You can also open Saved records > People.
  2. Select the people you want to add.
  3. Click Workflow. If Workflow isn't visible, click More > Workflow.
  4. Select an active workflow. Click All, My, or Team, or search for a workflow by name. In the Active workflows window, the All, My, and Team options and search field help you select a workflow for manual enrollment.
  5. Review the selected people. If any have already entered the workflow, select the people you want to add again, then click Add records. To exclude them, click Skip these records.
  6. Review the enrollment details, then click Confirm enrollment. If the workflow reached its enrollment limit and you want to continue, click Override and enroll.

You have now manually added the selected people to the workflow. Manual workflow runs appear in the workflow history as Run #N (Manual run).

Apollo doesn't currently support manually adding companies or deals to an existing workflow from their respective search pages. To control whether a record can enter an automatic workflow more than once, configure the workflow's re-enrollment settings.

Back to Top

Troubleshoot a Workflow

Use the following questions to identify why a workflow or record didn't behave as expected. Each answer includes checks you can complete in Apollo and steps to correct the issue.

Common workflow concerns

Why didn't the workflow run? Why wasn't a record enrolled? Where can I review workflow enrollment and activity?
Why did a record fail? Why can't I retry a failed record? Why did a sequence use an unexpected sender?

Why didn't the workflow run?

A workflow only evaluates records when it is active and its configured schedule or trigger event occurs. Check the workflow status and trigger before changing its enrollment criteria.

To troubleshoot a workflow that didn't run:

  1. Launch Apollo, then click Workflows.
  2. Locate the workflow and confirm that it is active. If it is inactive, open it, review its configuration, then click Launch workflow.
  3. Open the workflow and click Workflow. Review the trigger block:
    • For a scheduled workflow, confirm the start date, frequency, selected days, timezone, optional end date, and next run date.
    • For an event-triggered workflow, confirm that the selected event occurred while the workflow was active.
  4. Confirm that the workflow isn't archived. Archived workflows can't run.
  5. Open Settings and confirm that the workflow hasn't reached a configured run, record, or credit limit.
  6. Correct the trigger or settings, then publish the changes. Check out Configure Workflow Triggers and Actions for complete trigger instructions.
 
No Looking Back

Event-triggered workflows only process events that occur while the workflow is active. Activating a workflow doesn't enroll records for earlier events. Event processing isn't immediate, and some triggers can take longer depending on when Apollo receives and evaluates the event.

Back to Common Workflow Concerns

Why wasn't a record enrolled?

A workflow can run without enrolling a particular record. The record must match the workflow target, trigger, enrollment criteria, and re-enrollment settings when Apollo evaluates it.

To troubleshoot a record that wasn't enrolled:

  1. Open the workflow and confirm that the record matches its target: people, companies, or deals.
  2. Click Edit workflow, then open the trigger block.
  3. Review every enrollment filter and its AND/OR logic. Confirm that the record contains the required data and matches each filter value.
  4. For an event-triggered workflow, confirm that the event occurred while the workflow was active. Apollo doesn't backfill events that happened before activation.
  5. Open Settings and review the re-enrollment setting:
    • Every run allows the record to enter whenever it meets the criteria.
    • Only once prevents a record from entering again after its first enrollment.
    • Once every allows the record to enter again after the configured period.
  6. Click Enrollment and check whether the record appears as Skipped or Failed. Review the reason displayed under the status.
  7. Correct the filters, re-enrollment setting, or processing limit, then publish the changes. Check out Configure Workflow Triggers and Actions to update enrollment criteria.

Back to Common Workflow Concerns

Where can I review workflow enrollment and activity?

Use Enrollment to follow records through each workflow run. Use Activity when you need to investigate the individual actions Apollo completed, skipped, or failed.

To check a workflow run:

  1. Launch Apollo, then click Workflows.
  2. Select the workflow, then click Enrollment.
  3. Select a run from Record runs. Runs appear as Run #N and include Trial run or Manual run when applicable.
  4. Review the target, run count, credit usage, enrolled records, and record status:
    • In Progress: Apollo is still processing the record.
    • Completed: Apollo completed the configured actions.
    • Failed: Apollo couldn't complete an action. Review the failure reason before retrying.
    • Skipped: Apollo didn't process the record because it didn't meet a requirement or the workflow reached a limit.
  5. To investigate a particular action, click Activity.
  6. Use Status, Failure reason, Action, or Completed in date range to narrow the activity.

Pending approval isn't a record status. Under Enrollment, review records that require approval in the separate Pending approvals section.

Back to Common Workflow Concerns

Why did a record fail?

Under Enrollment, the failure reason appears below the record's Failed status. Correct the underlying issue before retrying the record. Otherwise, the same action can fail again.

Failure reason How to fix it
Missing required owner
  1. Review the failure reason to determine whether Apollo needs a contact, account, or opportunity owner.
  2. Open the affected record and assign an active user as the required owner.
  3. For people and companies, follow Edit a Contact or Account Owner. For opportunities, open the deal and update its owner. Check out Access and Manage Deals for deal-management instructions.
  4. Return to Enrollment and retry the record.
Missing or inactive mailbox
  1. Click Edit workflow and open the sequence action that failed.
  2. Review Send email from to identify the user or owner whose mailbox Apollo expected to use.
  3. Confirm that the selected user is active and has an active mailbox connected to Apollo.
  4. If the mailbox is disconnected or missing, follow Link Your Mailbox to Apollo. You can also update the action to use another valid sender.
  5. Publish the workflow changes, then retry the failed record.
Credit error
  1. Open Enrollment and review the Credit usage card and displayed failure reason.
  2. Open Settings and check the maximum credits allowed for each run and for the workflow.
  3. Go to Settings > Credits and activity > Credit usage to confirm that your team has enough credits for the action.
  4. Increase the applicable workflow limit or ask an admin to address the team's available credits. Check out Review Credit Usage in Apollo for complete instructions.
  5. Return to Enrollment and retry the credit-limit failures.
Missing assignee
  1. Click Edit workflow and open the action that assigns a user.
  2. Confirm that the selected user is active and has access to the records or feature used by the action.
  3. Select another active user if the original assignee was deactivated or no longer has the required access. Admins can follow Add, Manage, and Deactivate Users to review the user's status.
  4. Publish the workflow changes, then retry the record.
Slack notification failure
  1. Confirm that Slack is still connected to your Apollo workspace. If it isn't, follow Integrate Slack with Apollo to reconnect it.
  2. Confirm that the Apollo app can access the selected Slack channel.
  3. Click Edit workflow, open the Slack notification action, and reselect a channel if the original channel was removed or restricted.
  4. Publish the workflow changes, then retry the record.
Record selection limit breached
  1. Open Enrollment and check whether the affected record is Failed or Skipped.
  2. Open Settings and review the maximum number of people or companies allowed for each run or workflow.
  3. Update the processing limit if your plan and permissions allow it, then publish the changes.
  4. Retry failed records. Skipped records aren't failures, so Apollo evaluates them again only when they remain eligible for a future run or you add supported records manually.

Back to Common Workflow Concerns

Why can't I retry a failed record?

The workflow must be active before Apollo can retry failed records. Apollo displays Workflow is not active if you try to retry records while the workflow is inactive.

To retry failed records:

  1. Correct the ownership, mailbox, credit, assignee, or integration issue shown in the failure reason.
  2. Activate the workflow if it is inactive.
  3. Open the workflow and click Enrollment.
  4. Select the run that contains the failed records, then toggle on Show failed only.
  5. Retry all eligible failures or retry an individual record:
    • Click Retry failed records to retry all eligible failures.
    • Click Retry failed record on an individual row to retry only that record.

Apollo processes up to 10,000 records in a retry.

Back to Common Workflow Concerns

Why did a sequence use an unexpected sender?

The Send email from setting on the sequence action determines which mailbox Apollo uses. The selected sender source can resolve to a different user for each enrolled record.

To troubleshoot the sequence sender:

  1. Open the workflow and click Edit workflow.
  2. Open the action that adds people to the sequence.
  3. Review Send email from. Confirm that the workflow uses the intended source, such as the contact owner, account owner, opportunity owner, a custom field, a specific user, or round robin.
  4. Open the affected record and confirm that the selected owner or custom field resolves to the expected active user.
  5. Confirm that the expected user has an active mailbox. If necessary, follow Link Your Mailbox to Apollo to connect it.
  6. Update the sender source or record ownership, publish the changes, and retry any failed records.

For deal workflows, Apollo uses Opportunity owner, not Deal owner, in the sender options. Deal workflows don't automatically fall back to another mailbox when the selected owner doesn't have an active one.

If the same person is associated with multiple deals that trigger the workflow, Apollo uses the most recently created triggering deal to determine the sequence sender.

Back to Common Workflow Concerns

Back to Top

Next Steps

Keep building and managing your workflows with these resources:

Back to Top