Access the GetResponse API with managed OAuth authentication. Manage email marketing campaigns, contacts, newsletters, autoresponders, segments, and forms.
Reference
Get Account Details
GET /getresponse/v3/accountsGet Billing Info
GET /getresponse/v3/accounts/billingList Campaigns
GET /getresponse/v3/campaignsWith pagination:
GET /getresponse/v3/campaigns?page=1&perPage=100Get Campaign
GET /getresponse/v3/campaigns/{campaignId}Create Campaign
POST /getresponse/v3/campaigns
Content-Type: application/json
{
"name": "My Campaign"
}List Contacts
GET /getresponse/v3/contactsWith campaign filter:
GET /getresponse/v3/contacts?query[campaignId]={campaignId}With pagination:
GET /getresponse/v3/contacts?page=1&perPage=100With sorting:
GET /getresponse/v3/contacts?sort[createdOn]=descGet Contact
GET /getresponse/v3/contacts/{contactId}Create Contact
POST /getresponse/v3/contacts
Content-Type: application/json
{
"email": "john@example.com",
"name": "John Doe",
"campaign": {
"campaignId": "abc123"
},
"customFieldValues": [
{
"customFieldId": "xyz789",
"value": ["Custom Value"]
}
]
}Update Contact
POST /getresponse/v3/contacts/{contactId}
Content-Type: application/json
{
"name": "John Smith",
"customFieldValues": [
{
"customFieldId": "xyz789",
"value": ["Updated Value"]
}
]
}Delete Contact
DELETE /getresponse/v3/contacts/{contactId}Get Contact Activities
GET /getresponse/v3/contacts/{contactId}/activitiesList Custom Fields
GET /getresponse/v3/custom-fieldsGet Custom Field
GET /getresponse/v3/custom-fields/{customFieldId}Create Custom Field
POST /getresponse/v3/custom-fields
Content-Type: application/json
{
"name": "company",
"type": "text",
"hidden": false,
"values": []
}List Newsletters
GET /getresponse/v3/newslettersSend Newsletter
POST /getresponse/v3/newsletters
Content-Type: application/json
{
"subject": "Newsletter Subject",
"name": "Internal Newsletter Name",
"campaign": {
"campaignId": "abc123"
},
"content": {
"html": "<html><body>Newsletter content</body></html>",
"plain": "Newsletter content"
},
"sendOn": "2026-02-15T10:00:00Z"
}Send Draft Newsletter
POST /getresponse/v3/newsletters/send-draft
Content-Type: application/json
{
"messageId": "newsletter123",
"sendOn": "2026-02-15T10:00:00Z"
}List RSS Newsletters
GET /getresponse/v3/rss-newslettersList Tags
GET /getresponse/v3/tagsGet Tag
GET /getresponse/v3/tags/{tagId}Create Tag
POST /getresponse/v3/tags
Content-Type: application/json
{
"name": "VIP Customer"
}Update Tag
POST /getresponse/v3/tags/{tagId}
Content-Type: application/json
{
"name": "Premium Customer"
}Delete Tag
DELETE /getresponse/v3/tags/{tagId}Assign Tags to Contact
POST /getresponse/v3/contacts/{contactId}/tags
Content-Type: application/json
{
"tags": [
{"tagId": "abc123"},
{"tagId": "xyz789"}
]
}List Autoresponders
GET /getresponse/v3/autorespondersGet Autoresponder
GET /getresponse/v3/autoresponders/{autoresponderId}Create Autoresponder
POST /getresponse/v3/autoresponders
Content-Type: application/json
{
"name": "Welcome Email",
"subject": "Welcome to our list!",
"campaign": {
"campaignId": "abc123"
},
"triggerSettings": {
"dayOfCycle": 0
},
"content": {
"html": "<html><body>Welcome!</body></html>",
"plain": "Welcome!"
}
}Update Autoresponder
POST /getresponse/v3/autoresponders/{autoresponderId}
Content-Type: application/json
{
"subject": "Updated Welcome Email"
}Delete Autoresponder
DELETE /getresponse/v3/autoresponders/{autoresponderId}Get Autoresponder Statistics
GET /getresponse/v3/autoresponders/{autoresponderId}/statisticsGet All Autoresponder Statistics
GET /getresponse/v3/autoresponders/statisticsList From Fields
GET /getresponse/v3/from-fieldsGet From Field
GET /getresponse/v3/from-fields/{fromFieldId}Note: Transactional email endpoints may require additional OAuth scopes that are not included in the default authorization.
List Transactional Emails
GET /getresponse/v3/transactional-emailsSend Transactional Email
POST /getresponse/v3/transactional-emails
Content-Type: application/json
{
"fromField": {
"fromFieldId": "abc123"
},
"subject": "Your Order Confirmation",
"recipients": {
"to": "customer@example.com"
},
"content": {
"html": "<html><body>Order confirmed!</body></html>",
"plain": "Order confirmed!"
}
}Get Transactional Email
GET /getresponse/v3/transactional-emails/{transactionalEmailId}Get Transactional Email Statistics
GET /getresponse/v3/transactional-emails/statisticsList Imports
GET /getresponse/v3/importsCreate Import
POST /getresponse/v3/imports
Content-Type: application/json
{
"campaign": {
"campaignId": "abc123"
},
"contacts": [
{
"email": "user1@example.com",
"name": "User One"
},
{
"email": "user2@example.com",
"name": "User Two"
}
]
}Get Import
GET /getresponse/v3/imports/{importId}List Workflows
GET /getresponse/v3/workflowGet Workflow
GET /getresponse/v3/workflow/{workflowId}Update Workflow
POST /getresponse/v3/workflow/{workflowId}
Content-Type: application/json
{
"status": "enabled"
}List Segments
GET /getresponse/v3/search-contactsCreate Segment
POST /getresponse/v3/search-contacts
Content-Type: application/json
{
"name": "Active Subscribers",
"subscribersType": ["subscribed"],
"sectionLogicOperator": "or",
"section": []
}Get Segment
GET /getresponse/v3/search-contacts/{searchContactId}Update Segment
POST /getresponse/v3/search-contacts/{searchContactId}
Content-Type: application/json
{
"name": "Updated Segment Name"
}Delete Segment
DELETE /getresponse/v3/search-contacts/{searchContactId}Get Contacts from Segment
GET /getresponse/v3/search-contacts/{searchContactId}/contactsSearch Contacts Without Saving
POST /getresponse/v3/search-contacts/contacts
Content-Type: application/json
{
"subscribersType": ["subscribed"],
"sectionLogicOperator": "or",
"section": []
}Note: Forms endpoints may require additional OAuth scopes (form_view, form_design, form_select) that are not included in the default authorization.
List Forms
GET /getresponse/v3/formsGet Form
GET /getresponse/v3/forms/{formId}List Webforms
GET /getresponse/v3/webformsGet Webform
GET /getresponse/v3/webforms/{webformId}List SMS Messages
GET /getresponse/v3/smsSend SMS
POST /getresponse/v3/sms
Content-Type: application/json
{
"recipients": {
"campaignId": "abc123"
},
"content": {
"message": "Your SMS message content"
},
"sendOn": "2026-02-15T10:00:00Z"
}Get SMS Message
GET /getresponse/v3/sms/{smsId}Get SMS Statistics
GET /getresponse/v3/statistics/sms/{smsId}List Shops
GET /getresponse/v3/shopsCreate Shop
POST /getresponse/v3/shops
Content-Type: application/json
{
"name": "My Store",
"locale": "en_US",
"currency": "USD"
}Get Shop
GET /getresponse/v3/shops/{shopId}List Products
GET /getresponse/v3/shops/{shopId}/productsCreate Product
POST /getresponse/v3/shops/{shopId}/products
Content-Type: application/json
{
"name": "Product Name",
"url": "https://example.com/product",
"variants": [
{
"name": "Default",
"price": 29.99,
"priceTax": 32.99
}
]
}List Orders
GET /getresponse/v3/shops/{shopId}/ordersCreate Order
POST /getresponse/v3/shops/{shopId}/orders
Content-Type: application/json
{
"contactId": "abc123",
"totalPrice": 99.99,
"currency": "USD",
"status": "completed"
}List Webinars
GET /getresponse/v3/webinarsGet Webinar
GET /getresponse/v3/webinars/{webinarId}List Landing Pages
GET /getresponse/v3/lpsGet Landing Page
GET /getresponse/v3/lps/{lpsId}Get Landing Page Statistics
GET /getresponse/v3/statistics/lps/{lpsId}/performance