KosmoKrator

email_marketing

GetResponse CLI for AI Agents

Use the GetResponse CLI from KosmoKrator to call GetResponse tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

10 functions 6 read 4 write API key auth
Submit GetResponse feedback View package source

GetResponse CLI Setup

GetResponse can be configured headlessly with `kosmokrator integrations:configure getresponse`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure getresponse --set api_key="$GETRESPONSE_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor getresponse --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
api_key GETRESPONSE_API_KEY Secret secret yes API Key
url GETRESPONSE_URL URL url no API Base URL

Call GetResponse Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call getresponse.getresponse_list_contacts '{
  "page": 1,
  "perPage": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:getresponse getresponse_list_contacts '{
  "page": 1,
  "perPage": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function. 

kosmo integrations:docs getresponse --json
kosmo integrations:docs getresponse.getresponse_list_contacts --json
kosmo integrations:schema getresponse.getresponse_list_contacts --json
kosmo integrations:search "GetResponse" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to GetResponse.

getresponse.getresponse_list_contacts

Read read

List contacts in your GetResponse account. Returns paginated results with contact details including email, name, and campaign.

Parameters
page, perPage

Generic CLI call

kosmo integrations:call getresponse.getresponse_list_contacts '{"page":1,"perPage":1}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_list_contacts '{"page":1,"perPage":1}' --json

getresponse.getresponse_get_contact

Read read

Get details of a specific contact in GetResponse by its unique identifier.

Parameters
id

Generic CLI call

kosmo integrations:call getresponse.getresponse_get_contact '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_get_contact '{"id":"example_id"}' --json

getresponse.getresponse_create_contact

Write write

Create a new contact in GetResponse. Requires an email address. Optionally set the contact name and assign to a campaign.

Parameters
email, name, campaign

Generic CLI call

kosmo integrations:call getresponse.getresponse_create_contact '{"email":"example_email","name":"example_name","campaign":"example_campaign"}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_create_contact '{"email":"example_email","name":"example_name","campaign":"example_campaign"}' --json

getresponse.getresponse_update_contact

Write write

Update an existing contact's details in GetResponse. Provide the contact ID and the fields to update.

Parameters
id, name

Generic CLI call

kosmo integrations:call getresponse.getresponse_update_contact '{"id":"example_id","name":"example_name"}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_update_contact '{"id":"example_id","name":"example_name"}' --json

getresponse.getresponse_delete_contact

Write write

Delete a contact from GetResponse. This action is permanent and cannot be undone.

Parameters
id

Generic CLI call

kosmo integrations:call getresponse.getresponse_delete_contact '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_delete_contact '{"id":"example_id"}' --json

getresponse.getresponse_list_campaigns

Read read

List all campaigns in your GetResponse account. Returns campaign IDs and names that can be used when creating contacts.

Parameters
none

Generic CLI call

kosmo integrations:call getresponse.getresponse_list_campaigns '{}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_list_campaigns '{}' --json

getresponse.getresponse_get_campaign

Read read

Get details of a specific campaign in GetResponse by its unique identifier.

Parameters
id

Generic CLI call

kosmo integrations:call getresponse.getresponse_get_campaign '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_get_campaign '{"id":"example_id"}' --json

getresponse.getresponse_create_campaign

Write write

Create a new email campaign in GetResponse. Campaigns are used to organize and send emails to contact lists.

Parameters
name

Generic CLI call

kosmo integrations:call getresponse.getresponse_create_campaign '{"name":"example_name"}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_create_campaign '{"name":"example_name"}' --json

getresponse.getresponse_list_newsletters

Read read

List newsletters in your GetResponse account. Returns newsletter details including subject, status, and send dates.

Parameters
none

Generic CLI call

kosmo integrations:call getresponse.getresponse_list_newsletters '{}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_list_newsletters '{}' --json

getresponse.getresponse_get_current_user

Read read

Get the authenticated user's account information from GetResponse, including email, name, and account details.

Parameters
none

Generic CLI call

kosmo integrations:call getresponse.getresponse_get_current_user '{}' --json

Provider shortcut

kosmo integrations:getresponse getresponse_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

getresponse.getresponse_list_contacts

List contacts in your GetResponse account. Returns paginated results with contact details including email, name, and campaign.

Operation
Read read
Schema command
kosmo integrations:schema getresponse.getresponse_list_contacts --json
ParameterTypeRequiredDescription
page integer no Page number (1-based). Default: 1.
perPage integer no Number of contacts per page (max 1000). Default: 50.

getresponse.getresponse_get_contact

Get details of a specific contact in GetResponse by its unique identifier.

Operation
Read read
Schema command
kosmo integrations:schema getresponse.getresponse_get_contact --json
ParameterTypeRequiredDescription
id string yes The unique contact identifier.

getresponse.getresponse_create_contact

Create a new contact in GetResponse. Requires an email address. Optionally set the contact name and assign to a campaign.

Operation
Write write
Schema command
kosmo integrations:schema getresponse.getresponse_create_contact --json
ParameterTypeRequiredDescription
email string yes The contact's email address.
name string no The contact's full name.
campaign string no Campaign ID to add the contact to.

getresponse.getresponse_update_contact

Update an existing contact's details in GetResponse. Provide the contact ID and the fields to update.

Operation
Write write
Schema command
kosmo integrations:schema getresponse.getresponse_update_contact --json
ParameterTypeRequiredDescription
id string yes The unique contact identifier.
name string no The new name for the contact.

getresponse.getresponse_delete_contact

Delete a contact from GetResponse. This action is permanent and cannot be undone.

Operation
Write write
Schema command
kosmo integrations:schema getresponse.getresponse_delete_contact --json
ParameterTypeRequiredDescription
id string yes The unique contact identifier to delete.

getresponse.getresponse_list_campaigns

List all campaigns in your GetResponse account. Returns campaign IDs and names that can be used when creating contacts.

Operation
Read read
Schema command
kosmo integrations:schema getresponse.getresponse_list_campaigns --json
ParameterTypeRequiredDescription
No parameters.

getresponse.getresponse_get_campaign

Get details of a specific campaign in GetResponse by its unique identifier.

Operation
Read read
Schema command
kosmo integrations:schema getresponse.getresponse_get_campaign --json
ParameterTypeRequiredDescription
id string yes The unique campaign identifier.

getresponse.getresponse_create_campaign

Create a new email campaign in GetResponse. Campaigns are used to organize and send emails to contact lists.

Operation
Write write
Schema command
kosmo integrations:schema getresponse.getresponse_create_campaign --json
ParameterTypeRequiredDescription
name string yes The name for the new campaign.

getresponse.getresponse_list_newsletters

List newsletters in your GetResponse account. Returns newsletter details including subject, status, and send dates.

Operation
Read read
Schema command
kosmo integrations:schema getresponse.getresponse_list_newsletters --json
ParameterTypeRequiredDescription
No parameters.

getresponse.getresponse_get_current_user

Get the authenticated user's account information from GetResponse, including email, name, and account details.

Operation
Read read
Schema command
kosmo integrations:schema getresponse.getresponse_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.