GetResponse

GetResponse Contacts API

API documentation for contacts and their properties (e.g., tags, custom fields)

GitHub OpenAPI
Business capability
Customer Data Management BC-420.10

Operations 11

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

GET /contacts/{contactId}/activities List a contact's recent activities · Get a list of contact activities #
Ask an LLM
“What has a particular contact opened or clicked recently?”
“Can I see a contact's activity older than the last 14 days?”
Tell an agent
Show recent activity for contact {contact}.
List activities of contact {contact} from {from} to {to}.
GET /campaigns/{campaignId}/contacts List the contacts on one list · Get contacts from a single campaign #
Ask an LLM
“Who is subscribed to one specific contact list?”
“Can I find a subscriber by email within a single list?”
Tell an agent
List the contacts on list {campaign}.
Find contacts with email {email} on list {campaign}.
POST /contacts/{contactId}/custom-fields Add or update a contact's custom fields · Upsert the custom fields of a contact #
Ask an LLM
“Can I set custom field values on a contact without wiping the others?”
“What's the way to add a custom field value to just one subscriber?”
Tell an agent
Set custom field values {values} on contact {contact}.
Add or update custom fields on contact {contact} without removing existing ones.
POST /contacts/{contactId}/tags Add tags to a contact · Upsert the tags of a contact #
Ask an LLM
“How do I tag a subscriber without losing the tags they already have?”
“Can I attach several tags to a contact in one call?”
Tell an agent
Add tags {tags} to contact {contact}.
Tag contact {contact} while keeping its current tags.
GET /contacts/{contactId} Get a contact's details · Get contact details by contact ID #
Ask an LLM
“What information is stored about one particular subscriber?”
“Can I look up a contact's tags and custom fields by their ID?”
Tell an agent
Get the details of contact {contact}.
Show only {fields} for contact {contact}.
POST /contacts/{contactId} Update a contact's details · Update contact details #
Ask an LLM
“Can I change a subscriber's name or move them to another list?”
“Does updating a contact replace their existing tags and custom fields?”
Tell an agent
Rename contact {contact} to {name}.
Replace the tags on contact {contact} with {tags}.
DELETE /contacts/{contactId} Delete a contact · Delete a contact by contact ID #
Ask an LLM
“How do I permanently remove a subscriber from my account?”
“Can I record the message or IP address that triggered an unsubscribe when deleting a contact?”
Tell an agent destructive · confirm first
Delete contact {contact}.
Remove contact {contact}, attributing it to message {message}.
GET /contacts Search contacts across all lists · Get contact list #
Ask an LLM
“Which contacts across my whole account match a given email?”
“Can I find contacts that changed recently or came from a certain origin?”
Tell an agent
Find all contacts with email {email}.
List contacts created between {from} and {to} across every list.
POST /contacts Add a new contact to a list · Create a new contact #
Ask an LLM
“How can I add a single new subscriber to a list?”
“Can I set tags and custom fields while creating a contact?”
Tell an agent
Add {email} to list {campaign}.
Create contact {name} with email {email} on list {campaign}.
POST /contacts/batch Add many contacts in one request · Create multiple contacts at once #
Ask an LLM
“Can I import a bunch of contacts in one call instead of one at a time?”
“What throttling limits apply to bulk contact creation?”
Tell an agent
Add these contacts {contacts} to list {campaign} in one batch.
Bulk create contacts on list {campaign}.
GET /contacts/{contactId}/consents View a contact's consent fields · Get contact's consent fields #
Ask an LLM
“Has a given subscriber given marketing consent, and when did it change?”
“Where can I see the consent history for one contact?”
Tell an agent
Show consent fields for contact {contact}.
Check the consent status history of contact {contact}.

Documentation

📖
Documentation
https://apidocs.getresponse.com/v3
📖
APIReference
https://apireference.getresponse.com/
📖
Authentication
https://apidocs.getresponse.com/v3/authentication
📖
RateLimits
https://apidocs.getresponse.com/v3/limits

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/getresponse/refs/heads/main/openapi/getresponse-contacts-api-openapi.yml

Other Resources

🔗
Webhooks
https://apidocs.getresponse.com/v3/webhooks
🔗
ErrorCatalog
https://apidocs.getresponse.com/v3/errors
🔗
Postman
https://apidocs.getresponse.com/getresponse-postman-collection.zip

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/getresponse:getresponse-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.

GitHub Google LinkedIn

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

OpenAPI Specification

getresponse-contacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: GetResponse APIv3 Contacts API
  description: '# Limits and throttling


    GetResponse API calls are subject to throttling to ensure a high level of service for all users.'
  contact:
    name: API Support - DevZone
    url: https://app.getresponse.com/feedback.html?devzone=yes
    email: getresponse-devzone@cs.getresponse.com
  version: 3.2026-07-28T07:58:55+00:00
  x-logo:
    url: https://us-ws.gr-cdn.com/images/global/getresponse.png
servers:
- url: https://api.getresponse.com/v3
  description: GetResponse
- url: https://api3.getresponse360.com/v3
  description: GetResponse MAX US
- url: https://api3.getresponse360.pl/v3
  description: GetResponse MAX PL
tags:


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