Adding records to a pipeline and sending them

Updated Markdown

Records get into a pipeline through the Add menu, wait under To review in the pipeline's Activity, and go out when you click Send. This article covers that day-to-day flow. Setting up a pipeline is covered in "Pipelines — send records on to your CRM, Slack, e-mail or API".

Add records#

  1. From a list: select the rows, then in the selection bar click Add → Send to pipeline → (pipeline name).
  2. From the Watchlist: select contacts and use Add → Send to pipeline the same way.
  3. From the contact drawer: for a contact on the Watchlist, use Add → Send to pipeline in the drawer.
  4. From the Inbox: select recognized contacts and use Add → Send to pipeline; they are put on the Watchlist first, then added.
  5. Companies from the Watchlist: in Watchlist → Companies tick companies and use Add → Send to pipeline; they go in as company records (see "Companies on the Watchlist").
  6. From a list trigger, by itself: a trigger with the action Hand over to pipeline adds every record that meets its conditions (see "Triggers — hand records on automatically").

A confirmation shows how many contacts were added, how many were already in the pipeline, and how many are held for the data check; click it to open the pipeline. At the bottom of the pipeline menu, New pipeline starts a new one. Paused pipelines still appear in the menu (with a pause icon) and collect entries.

Pipelines take stored records only. A result in Person Search, Segment Search or AI Research has to be saved or added to a list first.

Send entries#

In Flows, click the pipeline under Activity → Pipelines (or Activity → beside the subtitle on its Setup page). The filter at the page's left edge reads To review · Running · Done; To review lists every waiting record as a row with a checkbox, its origin (List or Watchlist) and when it was added — 50 at a time, Show N more below loads the next ones. Tick some and click Send (number), or click Send all. A pipeline with nothing waiting shows one sentence and How do entries get here?, which opens the steps (select rows in a list → Add → Send to pipeline). Progress shows as "Sending 10 / 40 …". Sent entries leave To review and appear under Done. If you close the browser tab while sending, the rest simply keeps waiting. On a pipeline with automatic release, what it is sending by itself shows under Running.

Each record is read at the moment it is sent, so edits and enrichment you made after adding it are included.

Records from a "Deleted record" trigger#

A list trigger set to a record is deleted from the list (its card says "Deleted record") can hand a deleted record to a pipeline (see "Triggers — hand records on automatically"). The pipeline sends the record as it was at the moment it was deleted. ListPlus keeps a copy for that, and removes it once the pipeline has sent the record or you remove the entry from the pipeline. A copy that no pipeline has sent is removed after 30 days at the earliest, so send such entries within that time. A pipeline that writes into another list cannot be chosen for this. The record no longer exists in the list, so a link back to it, for example in a Slack message, does not open it.

Data check#

A pipeline can require records to meet conditions before they go out, set under Data check on the pipeline's Setup page — the same field · operator · value conditions as list triggers. Some targets also add their own requirement (HubSpot, for instance, always needs an e-mail) shown as a fixed tag. Records that don't meet the check wait under To review with the status To review, showing "Missing: …" for an empty required field or "Not met: …" for an unmet condition. They are not sent and nothing is written under Done. Enrich or fix the record, then click Send again: it is checked again and goes out if it now passes. See "The data check — only send records that meet your conditions" for how to build the conditions.

When sending fails#

A failed entry stays under To review as Error (with the number of attempts), and the reason is shown, for example "The Slack connection expired – reconnect the account." Fix the cause and send it again; nothing is retried automatically. Use the Failed filter to see only those. To drop entries you don't want to send, select them and remove them; Done records them as Removed.

Test before you send#

Test connection sits at the bottom of the pipeline's Setup page. Pick a sample record From a list or From watchlist to see exactly what would be sent, then:

  • Webhook: sends one real request, marked "test": true, and shows the response.
  • Slack: posts one real message to the channel.
  • Email: sends a test mail to you only.
  • All other targets (CRMs, sequencers, Sheets, Another list, Other app): Check (writes nothing) looks the record up in the target and reports what would happen, without writing anything.

A Webhook or Slack test is a real delivery and costs that target's price per record.

The test uses the saved setup, so save your changes first.

Done: the history of a pipeline#

Done in the pipeline's Activity lists every attempt with its result (Sent, Failed, Removed), the time, and for each one the data that was sent and the target's answer. Filter by Sent or Failed. It is kept for 30 days. Activity → Done shows the attempts of every pipeline together, newest first.

Related topics: pipelines-overview · pipeline-marks · email-pipeline · pipelines-crm-slack-and-webhook · automatic-release · pipeline-data-check · enrich-pipeline · selecting-rows · saved-contacts.

FAQ#

How do I add records to a pipeline?#

Select rows in a list or contacts on the Watchlist (or open a single contact's drawer), then click Add → Send to pipeline and pick the pipeline. The records wait under To review in the pipeline's Activity until someone clicks Send (or go out by themselves if the pipeline's Release is set to Automatic). A list trigger can also add records by itself.

Can I send contacts straight from Person Search or the Inbox to a pipeline?#

From the Inbox, yes: select recognized contacts and use Add → Send to pipeline, and they are put on the Watchlist first. Results in Person Search, Segment Search or AI Research must be saved or added to a list first, because pipelines only take stored records.

Can a contact on the Watchlist enter a pipeline by itself?#

No. The Watchlist doesn't hand contacts on by itself; you add them with Add → Send to pipeline. To hand records over automatically, put them in a list and let a list trigger with the action Hand over to pipeline do it.

I added records, why haven't they been sent yet?#

On a pipeline with Release set to Manual (the default), entries wait until someone opens the pipeline's Activity (Flows → Activity → Pipelines) and clicks Send or Send all under To review; with Release set to Automatic they go out by themselves. If nothing goes out, check that the pipeline isn't Paused and look for entries marked Check or Error.

What does the status "To review" or "Missing" mean on an entry?#

The pipeline's data check requires a field or condition this record doesn't meet yet, for example an e-mail address, so it waits and is not sent. Fill or enrich the record and click Send again; it is checked again and goes out once it meets the check.

Does the pipeline send the data as it was when I added the record?#

No, each record is read at the moment it is sent. Edits and enrichment results you added after putting it into the pipeline are included.

What happens if I add the same record twice?#

It stays in the pipeline once. The confirmation counts it as "already in", and the existing entry keeps its state.

A pipeline entry failed, how do I retry it?#

Failed entries stay under To review as Error with the reason shown, for example an expired connection or a missing e-mail. Fix the cause and click Send again; ListPlus does not retry automatically. The Errors filter shows only the failed ones.

How do I remove an entry from a pipeline without sending it?#

In the pipeline's Activity under To review, select the entries and remove them. They are logged as Removed under Done, and the record itself stays untouched in your list or on the Watchlist.

How do I test a pipeline before sending real records?#

Open the pipeline's Setup page, expand Test connection at the bottom and pick a sample record From a list or From watchlist. A webhook gets one real request marked "test": true, Slack gets one real message and Email mails only you (a Webhook or Slack test costs one record's delivery price); CRMs, sequencers, Sheets and the other targets use Check (writes nothing) and only report what would happen.

Where do I see what a pipeline sent, and how long is it kept?#

Under Done in the pipeline's Activity (Flows → Activity → Pipelines → the pipeline): every send attempt with its result (Sent, Failed or Removed), the time, the data that was sent and the target's answer, kept for 30 days.

What happens to a record that reaches a pipeline through a "Deleted record" trigger?#

The pipeline sends it as it was at the moment it was deleted, and the kept copy is removed once the pipeline has sent the record or the entry is removed from the pipeline. A pipeline that writes into another list cannot be chosen for this trigger. The record no longer exists in the list, so a link back to it (for example in a Slack message) does not open it.