GetResponse

GetResponse node reference - all 159 operations, the credential it needs, and a worked example.

GetResponse APIv3 (Email Marketing). 159 operations: contacts (add, bulk add, search, get, update, delete, activities, consents, tags, custom fields); segments and ad-hoc contact searches; tags; custom, predefined and GDPR fields; custom events including firing one at a contact; lists (campaigns), their contacts and blocklists; 'from' addresses, postal addresses, suppression lists and the account blocklist; imports; newsletters (send, schedule, send a draft, cancel, activities); RSS newsletters; autoresponders; subject-line A/B tests; SMS and transactional email (GetResponse MAX); the file library; and the ecommerce surface — shops, products and variants, categories, carts, orders, meta fields and taxes — plus automation workflows and account details.

Credential: GetResponse API key - see Credentials.

Permissions

GetResponse APIv3 has no scope, permission or capability system. Its OpenAPI document declares exactly two security schemes and neither is granular: the X-Auth-Token API key carries no scopes at all, and OAuth2 declares the single scope all - "all data access" - on every one of its flows. So one key reaches every operation below and a refusal is never a missing checkbox. A 401 means the key is wrong, was stored with the api-key prefix already attached (the node adds it), or has expired - GetResponse expires an API key that goes 90 days WITHOUT being used. A 403 usually means the feature is not on the plan: SMS and transactional email are GetResponse MAX (GetResponse360) products, and MAX accounts also answer on a different host and need their domain sent as an X-Domain header, which is what this node's MAX domain field switches on. Limit the blast radius by creating the key under a GetResponse user account with restricted access rather than the account owner.

Operations (159)

Contacts

Operation	What it does
`addContact`	Add contact to list
`listContacts`	List / search contacts
`getContact`	Get contact
`updateContact`	Update contact
`deleteContact`	Delete contact
`addContactsBatch`	Add contacts in bulk
`listContactActivities`	List a contact's activities
`getContactConsents`	Get a contact's consents
`upsertContactTags`	Add tags to a contact
`upsertContactCustomFields`	Set a contact's custom fields

Segments (saved searches)

Operation	What it does
`searchContacts`	Search contacts by conditions (ad-hoc)
`listSegments`	List segments
`getSegment`	Get segment
`createSegment`	Create segment
`updateSegment`	Update segment
`deleteSegment`	Delete segment
`listSegmentContacts`	List a segment's contacts
`upsertSegmentCustomFields`	Set custom fields on a segment

Operation	What it does
`listTags`	List tags
`getTag`	Get tag
`createTag`	Create tag
`updateTag`	Update tag
`deleteTag`	Delete tag

Operation	What it does
`listCustomFields`	List custom fields
`getCustomField`	Get custom field
`createCustomField`	Create custom field
`updateCustomField`	Update custom field
`deleteCustomField`	Delete custom field
`listPredefinedFields`	List predefined fields
`getPredefinedField`	Get predefined field
`createPredefinedField`	Create predefined field
`updatePredefinedField`	Update predefined field
`deletePredefinedField`	Delete predefined field
`listGdprFields`	List GDPR consent fields
`getGdprField`	Get GDPR consent field

Custom events

Operation	What it does
`triggerCustomEvent`	Trigger a custom event for a contact
`listCustomEvents`	List custom events
`getCustomEvent`	Get custom event
`createCustomEvent`	Create custom event
`updateCustomEvent`	Update custom event
`deleteCustomEvent`	Delete custom event

Lists (campaigns)

Operation	What it does
`listCampaigns`	List campaigns
`getCampaign`	Get campaign
`createCampaign`	Create campaign
`updateCampaign`	Update campaign
`listCampaignContacts`	List a campaign's contacts
`getCampaignBlocklist`	Get a campaign's blocklist
`updateCampaignBlocklist`	Update a campaign's blocklist

Senders, addresses & suppressions

Operation	What it does
`listFromFields`	List 'from' addresses
`getFromField`	Get 'from' address
`createFromField`	Create 'from' address
`deleteFromField`	Delete 'from' address
`setDefaultFromField`	Set default 'from' address
`listAddresses`	List postal addresses
`getAddress`	Get postal address
`createAddress`	Create postal address
`updateAddress`	Update postal address
`deleteAddress`	Delete postal address
`listSuppressions`	List suppression lists
`getSuppression`	Get suppression list
`createSuppression`	Create suppression list
`updateSuppression`	Update suppression list
`deleteSuppression`	Delete suppression list
`getAccountBlocklist`	Get the account blocklist
`updateAccountBlocklist`	Update the account blocklist

Imports

Operation	What it does
`listImports`	List imports
`getImport`	Get import
`createImport`	Start a contact import

Newsletters (broadcasts)

Operation	What it does
`sendNewsletter`	Send / schedule a newsletter
`sendNewsletterDraft`	Send an existing draft
`listNewsletters`	List newsletters
`getNewsletter`	Get newsletter
`cancelNewsletter`	Cancel a scheduled newsletter
`deleteNewsletter`	Delete newsletter
`listNewsletterActivities`	List a newsletter's activities

RSS newsletters

Operation	What it does
`listRssNewsletters`	List RSS newsletters
`getRssNewsletter`	Get RSS newsletter
`createRssNewsletter`	Create RSS newsletter
`updateRssNewsletter`	Update RSS newsletter
`deleteRssNewsletter`	Delete RSS newsletter

Autoresponders

Operation	What it does
`listAutoresponders`	List autoresponders
`getAutoresponder`	Get autoresponder
`createAutoresponder`	Create autoresponder
`updateAutoresponder`	Update autoresponder
`deleteAutoresponder`	Delete autoresponder

A/B tests

Operation	What it does
`listSubjectAbTests`	List subject-line A/B tests
`getSubjectAbTest`	Get subject-line A/B test
`createSubjectAbTest`	Create subject-line A/B test
`chooseAbTestWinner`	Choose the A/B test winner
`cancelAbTest`	Cancel A/B test
`deleteAbTest`	Delete A/B test

SMS (GetResponse MAX)

Operation	What it does
`sendSms`	Send SMS
`listSms`	List SMS messages
`getSms`	Get SMS message
`listSmsSenderNames`	List SMS sender names
`listSmsAutomations`	List SMS automation messages
`getSmsAutomation`	Get SMS automation message

Transactional email (GetResponse MAX)

Operation	What it does
`sendTransactionalEmail`	Send transactional email
`listTransactionalEmails`	List transactional emails
`getTransactionalEmail`	Get transactional email
`listTransactionalTemplates`	List transactional templates
`getTransactionalTemplate`	Get transactional template
`createTransactionalTemplate`	Create transactional template
`updateTransactionalTemplate`	Update transactional template
`deleteTransactionalTemplate`	Delete transactional template

File library

Operation	What it does
`listFiles`	List files
`getFile`	Get file
`uploadFile`	Upload a file
`deleteFile`	Delete file
`listFolders`	List folders
`createFolder`	Create folder
`deleteFolder`	Delete folder
`getFileQuota`	Get storage quota

Ecommerce: shops

Operation	What it does
`listShops`	List shops
`getShop`	Get shop
`createShop`	Create shop
`updateShop`	Update shop
`deleteShop`	Delete shop

Ecommerce: products

Operation	What it does
`listProducts`	List products
`getProduct`	Get product
`createProduct`	Create product
`updateProduct`	Update product
`deleteProduct`	Delete product
`upsertProductCategories`	Set a product's categories
`upsertProductMetaFields`	Set a product's meta fields
`listProductVariants`	List product variants
`getProductVariant`	Get product variant
`createProductVariant`	Create product variant
`updateProductVariant`	Update product variant
`deleteProductVariant`	Delete product variant

Ecommerce: categories

Operation	What it does
`listCategories`	List categories
`getCategory`	Get category
`createCategory`	Create category
`updateCategory`	Update category
`deleteCategory`	Delete category

Ecommerce: carts & orders

Operation	What it does
`listCarts`	List carts
`getCart`	Get cart
`createCart`	Create cart
`updateCart`	Update cart
`deleteCart`	Delete cart
`listOrders`	List orders
`getOrder`	Get order
`createOrder`	Create order
`updateOrder`	Update order
`deleteOrder`	Delete order

Ecommerce: meta fields & taxes

Operation	What it does
`listShopMetaFields`	List shop meta fields
`getShopMetaField`	Get shop meta field
`createShopMetaField`	Create shop meta field
`updateShopMetaField`	Update shop meta field
`deleteShopMetaField`	Delete shop meta field
`listTaxes`	List taxes
`getTax`	Get tax
`createTax`	Create tax
`updateTax`	Update tax
`deleteTax`	Delete tax

Automation & account

Operation	What it does
`listWorkflows`	List automation workflows
`getWorkflow`	Get automation workflow
`updateWorkflowStatus`	Enable / disable an automation workflow
`getAccount`	Get account details

Example

Add a contact to a campaign, which is how GetResponse subscribes someone

In GetResponse a "campaign" is the list, so subscribing someone means creating a contact against a campaign id. The id is not the name shown in the UI — resolve it with listCampaigns first rather than hardcoding a string that will not match.

Set Operation to addContact, then fill in:

Field	Value	Notes
`campaignId`	`{{ campaigns.[0].campaignId }}`	From a listCampaigns node — the campaign IS the list
`email`	`{{ myTrigger.email }}`
`name`	`{{ myTrigger.firstName }} {{ myTrigger.lastName }}`	GetResponse stores one name field, not first/last
`tagId`	`{{ vars.getresponseTrialTagId }}`	Optional tag applied at creation

Sets {{subscriber.contactId}}. GetResponse queues contact creation, so an immediate read-back may not find it yet.

On this page