Setup guide

Get EnrollCue running in your HubSpot account in about 10 minutes.

1. Before you start

2. Install EnrollCue

  1. Click Install EnrollCue (or Install on the HubSpot Marketplace listing).
  2. Choose the HubSpot account to connect.
  3. Review and accept the permissions. Some are optional, each for one feature:
    • Contact property schemas: lets EnrollCue create and maintain the “Planned sequence” property.
    • Leads, Deals, Companies, Tickets (read): needed to use the actions in workflows based on those records.
    • Contacts (write): needed for the Unenroll from sequence action (see Unenroll contacts).
    Without them, EnrollCue still enrolls contacts from contact workflows. Accept them all to use every feature; the console lists the features turned off.
  4. You land on a confirmation page. EnrollCue now appears in your workflows.

3. Add the action to a workflow

  1. Go to Automation > Workflows, and open or create a workflow based on contacts, leads, deals, companies or tickets.
  2. Click + to add an action, search for EnrollCue, and choose Enroll in a sequence.
  3. Under Sequence, choose A specific sequence and pick it, or The sequence stored in a property of the record (see the next section).
  4. Under Send as, choose A specific user, or An owner property such as Contact owner or Deal owner to send from each record's owner.
  5. Save and turn on the workflow.

The action returns three outputs you can use in later steps, for example in an if/then branch: Enrollment ID, Error code and Error message. In deal, company and ticket workflows, it also returns Contacts enrolled, Contacts waiting and Contacts failed.

4. Choose the sequence with a property

Instead of one workflow (or one branch) per sequence, let each contact carry the sequence it should receive.

5. Deal, company, ticket and lead workflows

Sequences are always sent to contacts. When the workflow is based on another record, EnrollCue finds the contacts to enroll:

Each contact is enrolled separately: it gets its own line in the log, counts as one enrollment, and follows the sending limits. Up to 10 contacts are enrolled per record; use a label to target fewer. If the record has no matching contact, the action fails with NO_CONTACT. Each record type needs its optional permission.

Contacts that wait for room in a sender's daily limit are enrolled later in the background; the workflow doesn't wait for them.

6. Unenroll contacts

Add the Unenroll from sequence action to take contacts out of their sequence, for example when a deal moves to a later stage, a ticket is opened or a contact becomes a customer.

How it works. HubSpot offers no way for apps to unenroll a contact directly. HubSpot does unenroll contacts who book a meeting, so EnrollCue briefly logs a meeting called “Unenrolled from sequence (EnrollCue)” on the contact, checks that the contact has left the sequence, then deletes the meeting (it goes to HubSpot's recycle bin). This usually takes a few seconds, and at most a few minutes. Keep in mind:

7. Sending limits

To protect each sender's reputation, EnrollCue limits how many new enrollments each sender gets per day, in your account's time zone.

8. Track enrollments

Open the EnrollCue console in HubSpot: click the Marketplace icon in the top navigation bar, then EnrollCue under your recently visited apps. The confirmation page shown after installation also links to it. You'll find:

9. Errors and how to fix them

Error codeMeaningWhat to do
SENDER_NOT_ELIGIBLEThe sender can't send sequences.Give the sender a Sales Hub or Service Hub Professional seat and connect their inbox.
SENDER_NOT_FOUNDThe sender is not an active HubSpot user.Pick another sender, or check the owner property used by the action.
PERMISSION_DENIEDThe sender can't use this sequence.Share the sequence with the sender.
SEQUENCE_NOT_FOUNDThe sequence could not be found.The sequence was deleted, or the property holds a value that matches no sequence.
SEQUENCE_AMBIGUOUSSeveral sequences have this name.Use the “Planned sequence” property, which stores sequence IDs, or rename the duplicates.
ALREADY_ENROLLEDThe contact is already in a sequence.A contact can only be in one sequence at a time.
CONTACT_UNSUBSCRIBEDThe contact unsubscribed from sales emails.Expected: this protects your sending reputation.
CONTACT_NOT_EMAILABLEThe contact can't receive emails.A previous email bounced or was marked as spam. Check the address.
NO_CONTACTThe record has no contact to enroll.Give the lead a primary contact, or the deal, company or ticket a contact (with the association label chosen in the action, if any).
INVALID_INPUTThe action is missing a sequence or a sender.Check the action settings, and that the property used is filled in.
MISSING_PERMISSIONEnrollCue needs one more permission.Reauthorize EnrollCue from its console (“Reauthorize”), and accept all permissions.
NOT_CONNECTEDEnrollCue is no longer connected.Reinstall EnrollCue.
EXPIREDHubSpot stopped waiting for room in the sender's daily limit.Raise the limit or spread the volume across more senders, then re-enroll the record.
ENROLLMENT_REJECTEDHubSpot rejected the enrollment.See HubSpot's message in the error message output.
UNENROLL_REJECTEDUnenroll action: HubSpot refused the temporary meeting.See HubSpot's message in the error message output.
UNENROLL_NOT_CONFIRMEDUnenroll action: the contact was still in the sequence after 30 minutes.Check that the sequence unenrolls contacts who book a meeting (sequence settings).

10. Uninstall

Go to Settings > Integrations > Connected apps, open EnrollCue and choose Uninstall. Remove the EnrollCue action from your workflows first, otherwise they will report NOT_CONNECTED. See our privacy policy for what happens to your data.

Still stuck? Email support@enrollcue.com.