Add Contacts to Campaign (Bulk)

View as Markdown

The Add Contacts to Campaign (Bulk) node enrolls many contacts into a campaign at once. Give it a campaign and a list of contact IDs, and it enrolls them all together. It is the natural next step after a bulk import that produced a list of new contacts.

When to use it

  • You just created a batch of contacts and want them all enrolled in the same campaign.
  • An earlier step produced a list of contact IDs, for example from an import or a payload.
  • You want one step to enroll a whole segment rather than looping over people one at a time.

For a single contact, use Add Contact to Campaign instead.

Inputs

FieldWhat it’s forExample
CampaignThe campaign to enroll the contacts in, given by its ID.019c29ad-2f8f-7570-9b3c-4a202d9a4304
ContactsThe contact IDs to enroll, between 1 and 1,000. Usually the new contact IDs from an earlier bulk-add step.The successful IDs from Add Bulk Contacts

The Contacts field is commonly a single expression that points at the successful contact IDs from an Add Bulk Contacts step, so the two nodes chain together cleanly.

Outputs

FieldWhat you get back
OutcomeWhether the enrollment request succeeded.
Requested countHow many contact IDs were submitted.
FailuresA list of any contacts the campaign could not enroll, such as ones that were not found. Empty when everyone was accepted.

A few rejected contacts do not fail the node. It still enrolls the rest and lists the rejections under Failures, so you can react to them without blocking the whole batch.

Example

Chen Insurance Group imports 400 renewal prospects with Add Bulk Contacts, which returns the IDs of everyone created. The workflow feeds those IDs straight into Add Contacts to Campaign (Bulk) to enroll them all in the spring renewal campaign in one step.

The Add Contacts to Campaign (Bulk) node configuration panel, showing the campaign and the contact-IDs expression.

A few contacts failing to enroll does not fail the node, so check the Failures list if you need to know who was left out. Use a Check step to branch when the list is not empty.