Manage Segments, List Imports, and Suppression From the CLI and MCP
What this does
Everything you can do with contact segments, list imports and suppression in the Velaro Admin pages you can also do from the Velaro command line (velaro), from the Velaro MCP server for your AI assistant, and from the hosted Velaro MCP connection. Use it to build segments from a script, load a spreadsheet of contacts into a list in one step, and keep your do-not-email list current.
Email behavior segments are part of the Email Growth add-on. Availability depends on your plan; see your plan under Billing.
Create, change and delete segments
A segment is a name plus a list of conditions. You can use the same conditions as the Segments page, including behavior conditions such as opened an email within a number of days or had at least a number of opens, clicks, form submissions or site visits.
From the command line:
velaro contact-segment listshows your segments.velaro contact-segment create --name "Engaged Last 30 Days" --conditions '[{"field":"engagement_count_gte","value":"3@30"}]'creates one.velaro contact-segment update <id> --name "New Name" --conditions-file conditions.jsonchanges one.velaro contact-segment delete <id>removes one. Deleted segments can be restored for a limited time.velaro contact-segment fieldslists every condition and its value format.velaro contact-segment preview <id>shows how many contacts match now.
Velaro checks behavior conditions before saving. If a value is not in the right format, it tells you what to change and does not save the segment.
In an AI assistant, ask for the same thing in plain words, for example "Create a segment of contacts who opened at least 3 emails in the last 30 days". Your assistant uses the segment tools and asks you to confirm before it saves, changes or deletes anything.
Import a spreadsheet into a list
Run velaro contact-list import-file <listId> contacts.xlsx. You can use a .csv or .xlsx file. Velaro uploads the whole file in one request, then shows progress until the import finishes, with the number of rows added, skipped and rejected. The first row is the header and must include an email column.
To check an import later, run velaro contact-list import-status <importId>.
In an AI assistant, give it the file contents or a link to the file and the list name. It uploads the file and reports the result.
Manage suppression
Suppressed contacts never receive your marketing email.
velaro contact-list suppression listshows suppressed and unsubscribed addresses, with the reason and the date. Add--searchto look for an address.velaro contact-list suppression add someone@example.comstops all marketing email to that address.velaro contact-list suppression remove <id>lets an address receive email again.velaro contact-list suppression import suppress.csvsuppresses every address in a file in one step.
Only remove an address from suppression when the person has asked to hear from you again.
Good to know
Everything runs against your own account. You never enter a site number, and you only see and change your own data.
Was this article helpful?