lemlist Unsubscribes API
Suppression management - unsubscribe and re-subscribe contacts and variables, list and export the suppression set, and the legacy email/domain surface.
Operations 19
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“Is there an older trailing-slash route that lists unsubscribed emails?”
“Which legacy unsubscribe listing takes an offset and limit with a slash-terminated path?”
Tell an agent
Using the /unsubscribes/ trailing-slash route, list {limit} unsubscribed emails.
Page the slash-terminated unsubscribe list starting at offset {offset}.
Ask an LLM
“Can I download my unsubscribe list through the original unsubs export?”
“Which older endpoint exports every unsubscribed address in one file?”
Tell an agent
Export my unsubscribes using the legacy unsubs export.
Download the old-style unsubscribe export file.
GET
/unsubscribes/john.doe@domain.com
Check the sample john.doe@domain.com unsubscribe · Get Unsubscribe Email
#
Ask an LLM
“What does the documentation example for checking john.doe@domain.com return?”
“Is the sample address john.doe@domain.com on the unsubscribe list?”
Tell an agent
Check the sample address john.doe@domain.com against the unsubscribe list.
Run the documented example lookup for john.doe@domain.com.
POST
/unsubscribes/john.doe@domain.com
Unsubscribe the sample john.doe@domain.com · Add Unsubscribe Email/Domain
#
Ask an LLM
“What happens when I call the documentation example that unsubscribes john.doe@domain.com?”
“Can I try out adding an unsubscribe with the sample john.doe address?”
Tell an agent
Add the sample address john.doe@domain.com to the unsubscribe list.
Run the documented example that unsubscribes john.doe@domain.com.
DELETE
/unsubscribes/john.doe@domain.com
Remove the sample john.doe@domain.com unsubscribe · Delete Unsubscribe Email
#
Ask an LLM
“How does the documentation example for removing john.doe@domain.com from unsubscribes behave?”
“Can I take the sample john.doe address back off the unsubscribe list?”
Tell an agent destructive · confirm first
Delete the sample address john.doe@domain.com from the unsubscribe list.
Run the documented example that re-allows john.doe@domain.com.
Ask an LLM
“Which email addresses have unsubscribed from my campaigns?”
“How many unsubscribes come back per page by default?”
Tell an agent
List my unsubscribed email addresses.
Get {limit} unsubscribes starting at {offset}.
GET
/v2/unsubscribes/variables
List unsubscribed emails, domains, URLs and phones · List Unsubscribed Variables
#
Ask an LLM
“Which domains, LinkedIn URLs and phone numbers are on my do-not-contact list?”
“Can I page through every blocked variable, not just emails?”
Tell an agent
List all unsubscribed variables including domains and phone numbers.
Show {limit} blocked variables after skipping {offset}.
Ask an LLM
“How do I upload a big suppression list of emails and domains at once?”
“What's the maximum number of values I can unsubscribe in one request?”
Tell an agent
Bulk unsubscribe these values: {values}.
Add my suppression list {values} to the do-not-contact list in one go.
GET
/v2/unsubscribes/variables/{value}
Check if a domain, URL or phone is unsubscribed · Get Unsubscribed Variable
#
Ask an LLM
“Is a particular domain or phone number blocked from outreach?”
“Can I see the unsubscribe record for a specific LinkedIn URL?”
Tell an agent
Check whether {value} is on the v2 unsubscribe list.
Get the unsubscribed-variable record for {value}.
POST
/v2/unsubscribes/variables/{value}
Block a single email, domain, URL or phone · Unsubscribe Variable
#
Ask an LLM
“How do I block an entire domain from receiving any of my outreach?”
“What happens if I unsubscribe a value that's already blocked?”
Tell an agent
Block the domain, URL, phone or email {value} via the v2 list.
Add the single value {value} to the do-not-contact variables.
DELETE
/v2/unsubscribes/variables/{value}
Re-subscribe a blocked email, domain, URL or phone · Re-subscribe Variable
#
Ask an LLM
“How do I unblock a domain I added to the suppression list by mistake?”
“Why can't some unsubscribed values be re-subscribed?”
Tell an agent destructive · confirm first
Re-subscribe the variable {value}.
Unblock {value} on the v2 do-not-contact list.
GET
/v2/unsubscribes/contacts/{contactId}
Check a contact's do-not-contact status · Get Contact Subscription Status
#
Ask an LLM
“Is a given CRM contact flagged as do-not-contact?”
“Can I check whether a contact has opted out before reaching out?”
Tell an agent
Check if contact {contactId} is unsubscribed.
Get the subscription status of contact {contactId}.
Ask an LLM
“How do I mark a CRM contact so nobody on my team reaches out again?”
“Can I opt out a contact by their contact id?”
Tell an agent
Mark contact {contactId} as do-not-contact.
Opt out contact {contactId} from all outreach.
DELETE
/v2/unsubscribes/contacts/{contactId}
Clear a contact's do-not-contact flag · Re-subscribe Contact
#
Ask an LLM
“How do I allow outreach again to a contact who was opted out?”
“Can I remove the do-not-contact flag from a specific contact?”
Tell an agent destructive · confirm first
Re-subscribe contact {contactId}.
Clear the do-not-contact flag on contact {contactId}.
GET
/v2/unsubscribes/exports/variables
Export all unsubscribed variables to CSV · Export Unsubscribed Variables
#
Ask an LLM
“Can I download my full suppression list of emails, domains and phones as CSV?”
“Where do I export every blocked value at once?”
Tell an agent
Export all unsubscribed variables to a CSV.
Download my suppression list of emails and domains as a spreadsheet.
GET
/v2/unsubscribes/exports/contacts
Export contacts with subscription status to CSV · Export Unsubscribed Contacts
#
Ask an LLM
“How do I get a CSV of every contact and whether they're opted out?”
“Can I export contact subscription statuses for my CRM?”
Tell an agent
Export all contacts with their subscription status to CSV.
Download a spreadsheet of contacts showing who is do-not-contact.
Ask an LLM
“Has a specific email address unsubscribed from my emails?”
“Can I check one address's unsubscribe status before adding them?”
Tell an agent
Check whether {email} has unsubscribed.
Look up the unsubscribe entry for {email}.
POST
/unsubscribes/{email}
Unsubscribe an email address or domain · Add Unsubscribe Email or Domain
#
Ask an LLM
“How do I stop all future emails to a person who asked to opt out?”
“Can I add an address to my unsubscribe list by email?”
Tell an agent
Unsubscribe {email}.
Add {email} to my unsubscribe list.
Ask an LLM
“How do I take an email address off the unsubscribe list?”
“Can I let someone who opted out receive emails again?”
Tell an agent destructive · confirm first
Remove {email} from the unsubscribe list.
Allow emails to {email} again.