SendPulse Contacts API

The Contacts API from SendPulse — 51 operation(s) for contacts.

Business capability
Customer Data Management BC-420.10

Operations 57

POST /contacts/get-list Get contacts list #
POST /contacts/get-list-by-email Search contacts by email #
POST /contacts (Deprecated). Use POST /contacts/create instead to create a new contact #
POST /contacts/create Create a new contact #
GET /contacts/{contactId} Get information about a contact by ID #
PUT /contacts/{contactId} Update information about the contact #
DELETE /contacts/{contactId} Remove contact by ID #
GET /contacts/{contactId}/deals Get all deals that related to contact #
POST /contacts/{contactId}/comments Add a note to a contact #
PUT /contacts/{contactId}/comments/{commentId} Update contact note #
DELETE /contacts/{contactId}/comments/{commentId} Remove contact note #
GET /contacts/{contactId}/edu-payments Get EDU payments by contact #
GET /contacts/{contactId}/edu-statistic Get EDU statistics for a contact #
GET /contacts/external/{externalContactId} Get contact exists by external contact Id #
GET /contacts/messenger-external/{messengerContactId} Get contact by messenger contact id #
POST /contacts/{contactId}/relation/{companyId} Add contact to a company #
DELETE /contacts/{contactId}/relation/{companyId} Delete a contact from the company #
GET /contacts/get Get contact info via a contact ID #
GET /contacts/getByTag Get a list of contacts by tag #
GET /contacts/getByVariable Get a list of contacts by variable #
POST /contacts/sendText Send a text message to a contact #
POST /contacts/send Send message to a contact #
POST /contacts/sendTyping Send typing indicator #
POST /contacts/setVariable Assign a variable to contact #
POST /contacts/deleteVariable Delete a variable the selected contact #
PUT /contacts/mark-read Mark messages as read #
PUT /contacts/mark-unread Mark a chat with the contact as unread #
POST /contacts/setTag Assign a tag to a contact #
POST /contacts/deleteTag Remove a tag from a contact #
POST /contacts/disable Disable contact #
POST /contacts/enable Enable contact #
POST /contacts/delete Delete contact #
GET /contacts/getPauseAutomation Get remaining time for automation pause #
POST /contacts/setPauseAutomation Pause autoflows for a contact #
POST /contacts/deletePauseAutomation Resume autoflows for a contact #
GET /contacts/notes Get a list of contact's operator notes #
POST /contacts/createNote Send operator note #
POST /contacts/updateNote Update operator note #
POST /contacts/deleteNote Update operator note #
POST /contacts/operators/assign Assign a responsible for the chat #
POST /contacts/operators/unAssign Unassign responsible operators for the chat #
POST /contacts/openChat Open chat for a contact #
POST /contacts/closeChat Close chat for a contact #
POST /sms/numbers Add phone numbers to a mailing list #
PUT /sms/numbers Update variables for multiple phone numbers #
DELETE /sms/numbers Remove phone numbers from a mailing list #
POST /sms/numbers/variables Add phone numbers with complex variables #
PUT /addressbooks/{id}/phone Change a phone number for a contact #
POST /addressbooks/{id}/phones/variable Change variables for a single phone contact #
GET /sms/numbers/info/{addressBookId}/{phoneNumber} Get information for a specific phone number #
GET /contacts/getByTelegramId Get contact by Telegram ID #
POST /contacts/react React to a message #
GET /contacts/getByPhone Get contact info by phone number #
POST /contacts/sendByPhone Send a free message to a contact by phone number #
POST /contacts/sendTemplate Send a template message to the specified contact #
POST /contacts/sendTemplateByPhone Send a template message to a contact by phone number #
POST /contacts/setName Set the contact's name #

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-contacts-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.

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

OpenAPI Specification

sendpulse-contacts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Sendpulse Contacts API
  x-refined-note:
  - x-ai-description differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Contacts across 5 of this provider''s published API definitions: sendpulse-crm-openapi.yml, sendpulse-facebook-openapi.yml, sendpulse-sms-openapi.yml, sendpulse-telegram-openapi.yml, sendpulse-whatsapp-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.sendpulse.com/crm/v1
- description: ''
  url: https://api.sendpulse.com/messenger
- url: https://api.sendpulse.com
- description: ''
  url: https://api.sendpulse.com/telegram
- description: ''
  url: https://api.sendpulse.com/whatsapp
security:
- apiKey: []
- oauth2: []
tags:


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