Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage GetResponse email marketing via API to handle campaigns, contacts, newsletters, tags, autoresponders, and segments with OAuth authentication.
Manage GetResponse email marketing via API to handle campaigns, contacts, newsletters, tags, autoresponders, and segments with OAuth authentication.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Access the GetResponse API with managed OAuth authentication. Manage email marketing campaigns, contacts, newsletters, autoresponders, segments, and forms.
# List campaigns python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/getresponse/v3/campaigns') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/getresponse/{native-api-path} Replace {native-api-path} with the actual GetResponse API endpoint path. The gateway proxies requests to api.getresponse.com and automatically injects your OAuth token.
All requests require the Maton API key in the Authorization header: Authorization: Bearer $MATON_API_KEY Environment Variable: Set your API key as MATON_API_KEY: export MATON_API_KEY="YOUR_API_KEY"
Sign in or create an account at maton.ai Go to maton.ai/settings Copy your API key
Manage your GetResponse OAuth connections at https://ctrl.maton.ai.
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=getresponse&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'getresponse'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF Response: { "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "getresponse", "metadata": {} } } Open the returned url in a browser to complete OAuth authorization.
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple GetResponse connections, specify which one to use with the Maton-Connection header: python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/getresponse/v3/campaigns') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF If omitted, the gateway uses the default (oldest) active connection.
Get Account Details GET /getresponse/v3/accounts Get Billing Info GET /getresponse/v3/accounts/billing
Campaigns in GetResponse are equivalent to email lists/audiences. List Campaigns GET /getresponse/v3/campaigns With pagination: GET /getresponse/v3/campaigns?page=1&perPage=100 Get Campaign GET /getresponse/v3/campaigns/{campaignId} Create Campaign POST /getresponse/v3/campaigns Content-Type: application/json { "name": "My Campaign" }
List Contacts GET /getresponse/v3/contacts With campaign filter: GET /getresponse/v3/contacts?query[campaignId]={campaignId} With pagination: GET /getresponse/v3/contacts?page=1&perPage=100 With sorting: GET /getresponse/v3/contacts?sort[createdOn]=desc Get 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}/activities
List Custom Fields GET /getresponse/v3/custom-fields Get 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/newsletters Send 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-newsletters
List Tags GET /getresponse/v3/tags Get 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/autoresponders Get 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}/statistics Get All Autoresponder Statistics GET /getresponse/v3/autoresponders/statistics
List From Fields GET /getresponse/v3/from-fields Get 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-emails Send 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/statistics
List Imports GET /getresponse/v3/imports Create 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/workflow Get 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-contacts Create 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}/contacts Search 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/forms Get Form GET /getresponse/v3/forms/{formId}
List Webforms GET /getresponse/v3/webforms Get Webform GET /getresponse/v3/webforms/{webformId}
List SMS Messages GET /getresponse/v3/sms Send 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/shops Create 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}/products Create 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}/orders Create 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/webinars Get Webinar GET /getresponse/v3/webinars/{webinarId}
List Landing Pages GET /getresponse/v3/lps Get Landing Page GET /getresponse/v3/lps/{lpsId} Get Landing Page Statistics GET /getresponse/v3/statistics/lps/{lpsId}/performance
Use page and perPage query parameters for pagination: GET /getresponse/v3/contacts?page=1&perPage=100 page - Page number (starts at 1) perPage - Number of records per page (max 1000) Response headers include pagination info: TotalCount - Total number of records TotalPages - Total number of pages CurrentPage - Current page number
const response = await fetch( 'https://gateway.maton.ai/getresponse/v3/contacts?perPage=10', { headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}` } } ); const contacts = await response.json();
import os import requests response = requests.get( 'https://gateway.maton.ai/getresponse/v3/contacts', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, params={'perPage': 10} ) contacts = response.json()
Campaign IDs and Contact IDs are alphanumeric strings All timestamps use ISO 8601 format (e.g., 2026-02-15T10:00:00Z) Field names use camelCase Rate limits: 30,000 requests per 10 minutes, 80 requests per second IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments
StatusMeaning400Missing GetResponse connection or invalid request401Invalid or missing Maton API key404Resource not found409Conflict (e.g., contact already exists)429Rate limited4xx/5xxPassthrough error from GetResponse API
Check that the MATON_API_KEY environment variable is set: echo $MATON_API_KEY Verify the API key is valid by listing connections: python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Ensure your URL path starts with getresponse. For example: Correct: https://gateway.maton.ai/getresponse/v3/contacts Incorrect: https://gateway.maton.ai/v3/contacts
GetResponse API Documentation GetResponse OpenAPI Spec Maton Community Maton Support
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.