productivity
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.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 reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.
| Key | Env var | Type | Required | Label |
|---|---|---|---|---|
api_key | GETRESPONSE_API_KEY | Secret secret | yes | API Key |
url | GETRESPONSE_URL | URL url | no | API Base URL |
Command Patterns
The generic command is stable across every integration. The provider shortcut is shorter for humans.
kosmo integrations:call getresponse.getresponse_list_contacts '{"page":1,"perPage":1}' --json kosmo integrations:getresponse getresponse_list_contacts '{"page":1,"perPage":1}' --json Discovery
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 Automation Contexts
The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.
CLI Functions
Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.
getresponse.getresponse_list_contacts
List contacts in your GetResponse account. Returns paginated results with contact details including email, name, and campaign.
read - Parameters
- page, perPage
kosmo integrations:call getresponse.getresponse_list_contacts '{"page":1,"perPage":1}' --json kosmo integrations:getresponse getresponse_list_contacts '{"page":1,"perPage":1}' --json getresponse.getresponse_get_contact
Get details of a specific contact in GetResponse by its unique identifier.
read - Parameters
- id
kosmo integrations:call getresponse.getresponse_get_contact '{"id":"example_id"}' --json kosmo integrations:getresponse getresponse_get_contact '{"id":"example_id"}' --json getresponse.getresponse_create_contact
Create a new contact in GetResponse. Requires an email address. Optionally set the contact name and assign to a campaign.
write - Parameters
- email, name, campaign
kosmo integrations:call getresponse.getresponse_create_contact '{"email":"example_email","name":"example_name","campaign":"example_campaign"}' --json kosmo integrations:getresponse getresponse_create_contact '{"email":"example_email","name":"example_name","campaign":"example_campaign"}' --json getresponse.getresponse_update_contact
Update an existing contact's details in GetResponse. Provide the contact ID and the fields to update.
write - Parameters
- id, name
kosmo integrations:call getresponse.getresponse_update_contact '{"id":"example_id","name":"example_name"}' --json kosmo integrations:getresponse getresponse_update_contact '{"id":"example_id","name":"example_name"}' --json getresponse.getresponse_delete_contact
Delete a contact from GetResponse. This action is permanent and cannot be undone.
write - Parameters
- id
kosmo integrations:call getresponse.getresponse_delete_contact '{"id":"example_id"}' --json kosmo integrations:getresponse getresponse_delete_contact '{"id":"example_id"}' --json getresponse.getresponse_list_campaigns
List all campaigns in your GetResponse account. Returns campaign IDs and names that can be used when creating contacts.
read - Parameters
- none
kosmo integrations:call getresponse.getresponse_list_campaigns '{}' --json kosmo integrations:getresponse getresponse_list_campaigns '{}' --json getresponse.getresponse_get_campaign
Get details of a specific campaign in GetResponse by its unique identifier.
read - Parameters
- id
kosmo integrations:call getresponse.getresponse_get_campaign '{"id":"example_id"}' --json kosmo integrations:getresponse getresponse_get_campaign '{"id":"example_id"}' --json getresponse.getresponse_create_campaign
Create a new email campaign in GetResponse. Campaigns are used to organize and send emails to contact lists.
write - Parameters
- name
kosmo integrations:call getresponse.getresponse_create_campaign '{"name":"example_name"}' --json kosmo integrations:getresponse getresponse_create_campaign '{"name":"example_name"}' --json getresponse.getresponse_list_newsletters
List newsletters in your GetResponse account. Returns newsletter details including subject, status, and send dates.
read - Parameters
- none
kosmo integrations:call getresponse.getresponse_list_newsletters '{}' --json kosmo integrations:getresponse getresponse_list_newsletters '{}' --json getresponse.getresponse_get_current_user
Get the authenticated user's account information from GetResponse, including email, name, and account details.
read - Parameters
- none
kosmo integrations:call getresponse.getresponse_get_current_user '{}' --json 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 2 parameters
kosmo integrations:schema getresponse.getresponse_list_contacts --json | Parameter | Type | Required | Description |
|---|---|---|---|
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 1 parameters
kosmo integrations:schema getresponse.getresponse_get_contact --json | Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The unique contact identifier. |
getresponse.getresponse_create_contact 3 parameters
kosmo integrations:schema getresponse.getresponse_create_contact --json | Parameter | Type | Required | Description |
|---|---|---|---|
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 2 parameters
kosmo integrations:schema getresponse.getresponse_update_contact --json | Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The unique contact identifier. |
name | string | no | The new name for the contact. |
getresponse.getresponse_delete_contact 1 parameters
kosmo integrations:schema getresponse.getresponse_delete_contact --json | Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The unique contact identifier to delete. |
getresponse.getresponse_list_campaigns 0 parameters
kosmo integrations:schema getresponse.getresponse_list_campaigns --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
getresponse.getresponse_get_campaign 1 parameters
kosmo integrations:schema getresponse.getresponse_get_campaign --json | Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The unique campaign identifier. |
getresponse.getresponse_create_campaign 1 parameters
kosmo integrations:schema getresponse.getresponse_create_campaign --json | Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | The name for the new campaign. |
getresponse.getresponse_list_newsletters 0 parameters
kosmo integrations:schema getresponse.getresponse_list_newsletters --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
getresponse.getresponse_get_current_user 0 parameters
kosmo integrations:schema getresponse.getresponse_get_current_user --json | Parameter | Type | Required | Description |
|---|---|---|---|
| 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.