SendPulse

SendPulse Mailing lists API

Endpoints related to Mailing lists.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 14

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

POST /addressbooks Create a mailing list · Create a mailing list #
Ask an LLM
“How do I create a new mailing list?”
“Can I set up a fresh address book for a campaign?”
Tell an agent
Create a mailing list called {bookName}.
Make a new address book named {bookName}.
GET /addressbooks List mailing lists · Get a list of mailing lists #
Ask an LLM
“What mailing lists do I have in my account?”
“Can I page through my address books with limit and offset?”
Tell an agent
List my mailing lists.
Show {limit} mailing lists starting at offset {offset}.
GET /addressbooks/{id} Get a mailing list's details · Get mailing list information #
Ask an LLM
“What details are available about one specific mailing list?”
“Can I check a single address book's information by ID?”
Tell an agent
Get details for mailing list {id}.
Show me information about address book {id}.
PUT /addressbooks/{id} Rename a mailing list · Edit a mailing list #
Ask an LLM
“Can I rename an existing mailing list?”
“Is there a way to change an address book's name?”
Tell an agent
Rename mailing list {id} to {name}.
Change the name of address book {id} to {name}.
DELETE /addressbooks/{id} Delete a mailing list · Delete a mailing list #
Ask an LLM
“How do I permanently delete a mailing list?”
“Is deleting an address book reversible?”
Tell an agent destructive · confirm first
Delete mailing list {id}.
Permanently remove address book {id}.
GET /addressbooks/{id}/variables List a mailing list's variables · Get a list of variables for a mailing list #
Ask an LLM
“Which variables are defined on a mailing list?”
“Can I see the custom fields available for contacts in an address book?”
Tell an agent
List the variables on mailing list {id}.
Show custom fields for address book {id}.
GET /addressbooks/{id}/emails List contacts in a mailing list · Get a list of emails from a mailing list #
Ask an LLM
“How do I get all the email contacts in a mailing list?”
“Can I list only active or only inactive subscribers of a list?”
Tell an agent
List the emails in mailing list {id}.
Show {limit} contacts from address book {id}.
POST /addressbooks/{id}/emails Add contacts to a mailing list · Add emails to a mailing list #
Ask an LLM
“Can I add subscribers to a mailing list with double opt-in?”
“What's the way to import email addresses into an existing list?”
Tell an agent
Add contacts to mailing list {id}.
Import these emails into address book {id} with single opt-in.
DELETE /addressbooks/{id}/emails Remove email addresses from a mailing list · Delete emails from a mailing list #
Ask an LLM
“How do I delete specific email addresses from a mailing list?”
“Can I remove several contacts from one list at once?”
Tell an agent destructive · confirm first
Delete {emails} from mailing list {id}.
Remove these addresses {emails} from address book {id}.
GET /addressbooks/{id}/emails/total Count contacts in a mailing list · Get the total number of contacts #
Ask an LLM
“How many contacts are in a mailing list?”
“Can I count just the active subscribers of a list?”
Tell an agent
Count the contacts in mailing list {id}.
Give me the total number of emails in address book {id}.
POST /addressbooks/{id}/emails/unsubscribe Unsubscribe contacts from a mailing list · Unsubscribe contacts from a mailing list #
Ask an LLM
“Can I mark contacts as unsubscribed in one list without deleting them?”
“What's the way to opt people out of a single mailing list?”
Tell an agent
Unsubscribe {emails} from mailing list {id}.
Move {emails} to unsubscribed in address book {id}.
GET /addressbooks/{id}/variables/{variableName}/{searchValue} Find list contacts by variable value · Get contacts by variable #
Ask an LLM
“Can I find contacts in a list whose custom variable equals a certain value?”
“Which subscribers in an address book have city set to Berlin?”
Tell an agent
Find contacts in mailing list {id} where {variableName} is {searchValue}.
Search address book {id} for {variableName} = {searchValue}.
PUT /addressbooks/{id}/phone Change a subscriber's phone number · Change a phone number for a contact #
Ask an LLM
“Can I update the phone number stored for a subscriber in a list?”
“Is there a way to edit a contact's Phone variable by email?”
Tell an agent
Set the phone for {email} in mailing list {id} to {phone}.
Change subscriber {email}'s phone number to {phone} in list {id}.
GET /addressbooks/{id}/cost Estimate the cost of sending to a list · Get campaign cost #
Ask an LLM
“How much would it cost to send a campaign to this mailing list?”
“Can I calculate the price of a mailing before sending it?”
Tell an agent
Calculate the campaign cost for mailing list {id}.
Estimate what sending to address book {id} will cost.

Documentation

📖
Documentation
https://sendpulse.com/integrations/api/bulk-email
📖
APIReference
https://sendpulse.com/integrations/api
📖
Documentation
https://sendpulse.com/integrations/api/smtp
📖
Documentation
https://sendpulse.com/integrations/api/bulk-sms
📖
Documentation
https://sendpulse.com/integrations/api
📖
Documentation
https://sendpulse.com/integrations/api/chatbot
📖
Documentation
https://sendpulse.com/integrations/api/web-push

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/sendpulse/refs/heads/main/openapi/sendpulse-mailing-lists-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/sendpulse:sendpulse-mailing-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

sendpulse-mailing-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: SendPulse Bulk Email Mailing lists API
  version: 1.0.0
  description: API for managing mailing lists, email campaigns, templates, and senders.
  x-ai-description: 'The Bulk Email API is the core engine for marketing automation at SendPulse.  It enables programmatic control over the entire email lifecycle.

    '
  license:
    name: Apache 2.0
    identifier: Apache-2.0
servers:
- url: https://api.sendpulse.com
  description: Production server
security:
- apiKey: []
- oauth2: []
tags:


# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sendpulse/refs/heads/main/openapi/sendpulse-mailing-lists-api-openapi.yml