> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to GlockApps

The GlockApps connector lets your AI agent act in each user's GlockApps account. Each user connects their own GlockApps API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 48 tools.

**Authentication:** API Key
**Categories:** Marketing, Monitoring
**Tools:** 48: 26 read, 16 write, 6 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=GLOCKAPPS)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the GlockApps connection

   In **AgentKit > Connections**, create a GlockApps connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'glockapps'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize GlockApps:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'glockapps_account_balance_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "glockapps"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize GlockApps:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="glockapps_account_balance_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their GlockApps credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'glockapps_account_balance_get',
  toolInput: {},
  connector: 'glockapps',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="glockapps_account_balance_get",
    tool_input={},
    connection_name="glockapps",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `glockapps_account_balance_get`

Get Spam Test Credit Balance · Read-only

Get the account's spam test credit balance.
Returns testCredits with balance, the credits left to spend, and planCredits, the credits the plan includes each period.
Use glockapps_account_balance_get before glockapps_manual_test_create or activating automatic tests, which spend one credit per run.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `glockapps_autotest_get`

Get Automatic Test · Read-only

Get one automatic test's settings.
Returns its schedule, letter, connected mailbox, provider groups, send settings, folder, note and active status.
Use glockapps_autotest_get before glockapps_autotest_update, which replaces every field. Use glockapps_autotest_results_list for its results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `autotest_id` (`string`, required): ID of the automatic test, from glockapps_autotests_short_list. Example: 6549fe4bf1d552cbdb5ef3a3.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"autotest_id":"<autotest_id>","project_id":"<project_id>"}`

### `glockapps_autotest_results_list`

List Automatic Test Results · Read-only

List the test results produced by an automatic test's runs.
Returns one report per run with inbox, spam and missing placement, filter scores and authentication results.
Use glockapps_autotest_results_list to track an autotest's placement over time. Use glockapps_test_report_get for one run's full report. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `autotest_id` (`string`, required): ID of the automatic test, from glockapps_autotests_short_list. Example: 6549fe4bf1d552cbdb5ef3a3.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `hide_failed` (`boolean`, optional): a boolean flag, if set to true, it will hide failed tests; the default value is false. Example: true.
- `limit` (`string`, optional): Number of results per page. Example: 10.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `sort_field` (`string`, optional): name of the autotest result field to sort by, default is "created" of the test result. Example: created.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: -1.

Example input: `{"autotest_id":"<autotest_id>","project_id":"<project_id>"}`

### `glockapps_autotests_list`

List Automatic Tests · Read-only

List a project's automatic (scheduled) tests with their full settings.
Returns autotests with schedule, letter, connected mailbox, provider groups, folder and active status.
Use glockapps_autotests_list for full settings. Use glockapps_autotests_short_list for a lighter list. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `active` (`boolean`, optional): allows to filter autotests based on the active status of the autotest: if set to "true", get active autotests; if set to "false", get inactive autotests. Example: true.
- `folder_id` (`string`, optional): folder ID, allow to filter tests by folder ID. Example: 64aff26141383479c220a619.
- `limit` (`string`, optional): Number of results per page. Example: 50.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_text` (`string`, optional): search text, allows to filter autotests based on the search text found in the autotests notes and also in the report note, report testId, report letter subject and fromEmail. Example: newsletter.
- `sending_account_id` (`string`, optional): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `sort_field` (`array`, optional): name of the response field to sort by, default is ID of the autotest. Example: ["created"].
- `sort_value` (`array`, optional): Sort order: 1 for ascending, -1 for descending. Example: [-1].

Example input: `{"project_id":"<project_id>"}`

### `glockapps_autotests_short_list`

List Automatic Tests (Short) · Read-only

List a project's automatic tests in short form.
Returns each autotest's ID, note, schedule, active status and folder.
Use glockapps_autotests_short_list to find autotest IDs. Use glockapps_autotest_get for one autotest's full settings. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `active` (`boolean`, optional): allows to filter autotests based on the active status of the autotest: if set to "true", get active autotests; if set to "false", get inactive autotests. Example: true.
- `folder_id` (`string`, optional): folder ID, allow to filter tests by folder ID. Example: 64aff26141383479c220a619.
- `limit` (`string`, optional): Number of results per page. Example: 50.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_text` (`string`, optional): search text, allows to filter autotests based on the search text found in the autotests notes and also in the report note, report testId, report letter subject and fromEmail. Example: newsletter.
- `sending_account_id` (`string`, optional): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `sort_field` (`array`, optional): name of the response field to sort by, default is ID of the autotest. Example: ["created"].
- `sort_value` (`array`, optional): Sort order: 1 for ascending, -1 for descending. Example: [-1].

Example input: `{"project_id":"<project_id>"}`

### `glockapps_blocklist_servers_list`

List Blocklist Servers · Read-only

List the blocklist (DNSBL) servers GlockApps checks sending IPs and domains against.
Returns the blocklist servers with their IDs and names.
Use glockapps_blocklist_servers_list to pick blocklistIds for glockapps_project_create or glockapps_project_update. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Number of results per page. Example: 100.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.

Example input: `{}`

### `glockapps_connected_mailbox_get`

Get Connected Mailbox · Read-only

Get one connected mailbox.
Returns its type, name, sender, proxy email, header settings and provider groups.
Use glockapps_connected_mailbox_get for one mailbox. Use glockapps_connected_mailboxes_list to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `sending_account_id` (`string`, required): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.

Example input: `{"project_id":"<project_id>","sending_account_id":"<sending_account_id>"}`

### `glockapps_connected_mailboxes_list`

List Connected Mailboxes · Read-only

List a project's connected mailboxes (SMTP, Google, Microsoft, Klaviyo or HubSpot accounts GlockApps can send tests from).
Returns mailboxes with their ID, name, type, sender address, proxy email and provider groups.
Use glockapps_connected_mailboxes_list to find a sendingAccountId for glockapps_manual_test_send or glockapps_autotest_create. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `ids` (`string`, optional): Comma-separated connected mailbox IDs to filter by. Example: 6650c1f2a1b2c3d4e5f60718.
- `limit` (`string`, optional): Number of results per page. Example: 50.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_regex` (`string`, optional): Search regular expression to filter connected mailboxes. Example: ^news.
- `search_text` (`string`, optional): Search text to filter connected mailboxes. Example: newsletter.
- `sort_field` (`string`, optional): Field name to sort by. Example: created.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: -1.
- `type` (`string`, optional): Optional connected mailbox type filter. Omit to return all types. Example: SMTP. One of: `SMTP`, `Microsoft`, `Google`, `Klaviyo`, `HubSpot`.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_folder_get`

Get Folder · Read-only

Get one folder.
Returns the folder's name, type and item count.
Use glockapps_folder_get for one folder. Use glockapps_folders_list to find folder IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folder_id` (`string`, required): Folder ID. Example: 64aff26141383479c220a619.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"folder_id":"<folder_id>","project_id":"<project_id>"}`

### `glockapps_folders_list`

List Folders · Read-only

List a project's folders of one type (manual test, autotest, proxy test or Mailchimp test folders).
Returns folders with their folderId, name, type and itemsCount.
Use glockapps_folders_list to find a folderId for filtering or moving tests. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folder_type` (`string`, required): folder type (mandatory field), allowed values: "manualTestFolder", "autotestFolder", "proxyTestFolder", "mailchimpTestFolder". Example: manualTestFolder. One of: `manualTestFolder`, `autotestFolder`, `proxyTestFolder`, `mailchimpTestFolder`.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `hide_empty` (`boolean`, optional): when true, folders with itemsCount equal to 0 are excluded from the results. Example: true.
- `item_search_text` (`string`, optional): search text for folder items; when set, only folders that contain matching items are returned and itemsCount reflects only the matching items. Example: newsletter.
- `limit` (`string`, optional): Number of results per page. Example: 10.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_text` (`string`, optional): search text, allows to filter folders by name (case-insensitive substring match). Example: newsletter.
- `sending_account_id` (`string`, optional): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `sort_field` (`string`, optional): name of the folder field to sort by, default is "created". Example: created.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: -1.

Example input: `{"folder_type":"manualTestFolder","project_id":"<project_id>"}`

### `glockapps_letter_get`

Get Letter · Read-only

Get one saved letter.
Returns its subject, sender, headers and content details.
Use glockapps_letter_get to check a letter before using it. Use glockapps_letters_list to find letter IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `letter_id` (`string`, required): ID of the saved letter, from glockapps_letters_list. Example: 6a2abf348fa8ec364101a803.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"letter_id":"<letter_id>","project_id":"<project_id>"}`

### `glockapps_letters_list`

List Letters · Read-only

List the saved letters (email messages) in a project.
Returns letters with their ID, subject, sender, type and tags.
Use glockapps_letters_list to find a letterId for glockapps_autotest_create or glockapps_manual_test_send. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `letter_type` (`string`, optional): Letter type filter, for example autoTest. Example: autoTest.
- `limit` (`string`, optional): Number of results per page. Example: 50.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_text` (`string`, optional): Search text to filter letters. Example: newsletter.
- `sort_field` (`string`, optional): Field name to sort by. Example: created.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: -1.
- `tags` (`string`, optional): Letter tags filter. Example: newsletter.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_project_get`

Get Project · Read-only

Get one project.
Returns the project's name, description, timezone, blocklistIds and autotest email address.
Use glockapps_project_get for one project's settings. Use glockapps_projects_list to find project IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_project_providers_list`

List Project Providers · Read-only

List the mailbox providers available to a project's tests, with their seed account regions and groups.
Returns providers (for example Gmail, Outlook, Yahoo) with provider group IDs, regions and seed accounts.
Use glockapps_project_providers_list to pick providerGroupIds for glockapps_manual_test_create or glockapps_autotest_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_projects_list`

List Projects · Read-only

List the projects in the GlockApps account.
Returns projects with their projectId, name, description, timezone and blocklist settings.
Use glockapps_projects_list first: almost every other tool needs a projectId. Use glockapps_project_get for one project. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`string`, optional): Number of results per page. Example: 50.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `sort_field` (`string`, optional): name of the response field to sort by, default is ID of the progect. Example: name.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: 1.

Example input: `{}`

### `glockapps_test_email_headers_get`

Get Received Email Headers · Read-only

Get the headers of the copy of a tested message that one seed mailbox received.
Returns the message headers, including Authentication-Results, Received and spam filter headers.
Use glockapps_test_email_headers_get to debug SPF, DKIM, DMARC or routing for one provider. Use glockapps_test_raw_email_get for the whole message.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Seed email address that received the message, from glockapps_test_seed_accounts_list or the test report. Example: seed@example.com.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.

Example input: `{"email":"<email>","project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_email_html_get`

Get Received Email HTML · Read-only

Get the HTML of the copy of a tested message that a seed mailbox received.
Returns the HTML as text.
Use glockapps_test_email_html_get to see what a provider delivered. Leave email empty to get a random inbox copy. Use glockapps_test_raw_email_get for the full raw message.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.
- `email` (`string`, optional): Seed email address that received the message, from glockapps_test_seed_accounts_list or the test report. Example: seed@example.com.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_email_info_get`

Get Test Content Analysis · Read-only

Get the content analysis of a tested message.
Returns message size, image and link counts, text-to-HTML details and other content checks, per test.
Use glockapps_test_email_info_get to see why a message may be filtered. Use glockapps_test_html_check_get for HTML compatibility issues.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): Test ID. Several test IDs can be given separated by commas. Example: 2023-07-14-08:55:20:441t.
- `limit` (`string`, optional): Number of results per page. Example: 50.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_html_check_get`

Get Test HTML Check · Read-only

Check the HTML part of a tested message for rendering and compatibility problems.
Returns the HTML issues found, with the email clients they affect.
Use glockapps_test_html_check_get for HTML problems. Use glockapps_test_email_info_get for size, links and images.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_letter_html_get`

Get Test Letter HTML · Read-only

Get the HTML part of the message that was tested.
Returns the HTML as text.
Use glockapps_test_letter_html_get for the message as sent. Use glockapps_test_email_html_get for the copy one seed mailbox received.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_raw_email_get`

Get Received Raw Email · Read-only

Get the raw source of the copy of a tested message that a seed mailbox received.
Returns the raw RFC 822 message (headers and body) as text.
Use glockapps_test_raw_email_get for the complete message source. Use glockapps_test_email_headers_get when you only need headers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.
- `email` (`string`, optional): Seed email address that received the message, from glockapps_test_seed_accounts_list or the test report. Example: seed@example.com.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_report_get`

Get Test Report · Read-only

Get the full report of one spam test.
Returns the test's status, inbox, spam and missing placement per provider and seed, Google, Barracuda and SpamAssassin scores, SPF, DKIM and DMARC results, and blocklist checks.
Use glockapps_test_report_get to read one test's results. Use glockapps_test_results_short_list to find test IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_results_list`

List Test Reports · Read-only

List a project's complete spam test reports, newest first by default.
Returns full reports with inbox, spam and missing placement per provider, spam filter scores, authentication and blocklist results.
Use glockapps_test_results_list when you need the results of many tests. Use glockapps_test_results_short_list for a lighter list of IDs and summary, and glockapps_test_report_get for one test. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `created_from` (`string`, optional): allows filtering tests by their creation date, starting from target date. Example: 2026-01-01T00:00:00Z.
- `created_to` (`string`, optional): allows filtering tests by their creation date, up to the target date. Example: 2026-01-31T23:59:59Z.
- `folder_id` (`string`, optional): allow to filter tests by folder ID. Example: 64aff26141383479c220a619.
- `hide_empty` (`boolean`, optional): hide empty (without results) tests, default is false. Example: true.
- `hide_failed` (`boolean`, optional): a boolean flag, if set to true, it will hide failed tests; the default value is false. Example: true.
- `integration_test_type` (`string`, optional): allow to filter integration tests by integration type, allowed values: mailchimp. Example: mailchimp. One of: `mailchimp`.
- `limit` (`string`, optional): Number of results per page. Example: 10.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_text` (`string`, optional): allow to filter tests by subject, mailFrom, note, test ID. Example: newsletter.
- `sending_account_id` (`string`, optional): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `sort_field` (`string`, optional): name of the response field to sort by, default is "created". Example: created.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: -1.
- `test_type` (`string`, optional): allow to filter tests by test type, allowed values: ManualTest, ProxyTest, AutoTest, IntegrationTest. Example: ManualTest. One of: `ManualTest`, `ProxyTest`, `AutoTest`, `IntegrationTest`.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_test_results_short_list`

List Short Test Reports · Read-only

List a project's spam test reports in short form.
Returns each test's testId, type, subject, sender, creation date, folder and summary placement figures.
Use glockapps_test_results_short_list to find tests quickly by date, folder, type or text. Use glockapps_test_report_get for one test's full report. Use page and limit to page through results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `created_from` (`string`, optional): allows filtering tests by their creation date, starting from target date. Example: 2026-01-01T00:00:00Z.
- `created_to` (`string`, optional): allows filtering tests by their creation date, up to the target date. Example: 2026-01-31T23:59:59Z.
- `folder_id` (`string`, optional): allow to filter tests by folder ID. Example: 64aff26141383479c220a619.
- `hide_empty` (`boolean`, optional): hide empty (without results) tests, default is false. Example: true.
- `hide_failed` (`boolean`, optional): a boolean flag, if set to true, it will hide failed tests; the default value is false. Example: true.
- `integration_test_type` (`string`, optional): allow to filter integration tests by integration type, allowed values: mailchimp. Example: mailchimp. One of: `mailchimp`.
- `limit` (`string`, optional): Number of results per page. Example: 25.
- `page` (`string`, optional): Page number, starting at 1 (default 1). Example: 1.
- `search_text` (`string`, optional): allow to filter tests by subject, mailFrom, note, test ID. Example: newsletter.
- `sending_account_id` (`string`, optional): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `sort_field` (`string`, optional): name of the response field to sort by, default is "created". Example: created.
- `sort_value` (`integer`, optional): Sort order: 1 for ascending, -1 for descending. Example: -1.
- `test_type` (`string`, optional): allow to filter tests by test type, allowed values: ManualTest, ProxyTest, AutoTest, IntegrationTest. Example: ManualTest. One of: `ManualTest`, `ProxyTest`, `AutoTest`, `IntegrationTest`.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_test_seed_accounts_list`

List Test Seed Addresses · Read-only

List the seed email addresses of a test.
Returns the seed addresses the message must be sent to, with their providers.
Use glockapps_test_seed_accounts_list to get the send list for a test created earlier. glockapps_manual_test_create already returns it for a new test.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_shared_link_get`

Get Test Shared Link · Read-only

Get a shareable link to a test's results.
Returns a public URL that opens the report without a GlockApps login.
Use glockapps_test_shared_link_get to share a report with a client or teammate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_autotest_create`

Create Automatic Test · Write

Create an automatic test that sends a saved letter (or a Klaviyo or HubSpot source email) to the seed list on a schedule; each run spends one spam test credit.
Returns the new autotest with its ID and next run time.
Use glockapps_autotest_create to monitor placement over time. Create the letter with glockapps_letter_raw_create and connect the mailbox in the GlockApps app first; set active true with a sendingAccountId to start the schedule.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `scheduler` (`object`, required): Autotest schedule. Exactly one valid cron specification is required. An object with cronSpecs, a list holding exactly one cron specification such as "0 9 * * 1" or "@every 24h", and optionally startAt (RFC3339) and cronDescription (use "{}"). Example: {"cronSpecs": ["0 9 * * 1"], "startAt": "2026-06-11T14:25:00Z", "cronDescription": "{}"}.
- `active` (`boolean`, optional): Active status of the autotest. If set to true, sendingAccountId and provider-specific content are required and the scheduler job is activated. Example: true.
- `folder_id` (`string`, optional): Autotest folder ID. If empty, the autotest is created in the Home folder. Example: 64aff26141383479c220a619.
- `force_run` (`boolean`, optional): If true, runs the autotest immediately after creation. Allowed only when active is true. Example: true.
- `letter_id` (`string`, optional): Saved Letter ID used by SMTP, Google, or Microsoft Automatic Tests. Omit for Klaviyo and HubSpot, which use provider-owned source content from sendSettings. Example: 6a2abf348fa8ec364101a803.
- `link_checker` (`boolean`, optional): Set true to check every link in the message. Example: true.
- `note` (`string`, optional): Free-text note shown with the item in GlockApps (autotest notes: up to 250 characters). Example: Weekly newsletter check.
- `notification_condition_ids` (`array`, optional): Notification condition IDs attached to the autotest. Example: ["5"].
- `provider_group_ids` (`array`, optional): Provider group IDs whose seed accounts receive the test, from glockapps_project_providers_list. Recommended over seed account IDs because GlockApps resolves the seeds at run time. Example: ["2", "3", "4"].
- `send_settings` (`object`, optional): Provider-specific delivery settings. Must match the selected Connected Mailbox type. Use the object matching the mailbox type: email.sendInterval for SMTP, Google or Microsoft; klaviyo.sourceCampaignId; or hubspot.marketing / hubspot.transactional with the source email ID. Example: {"email": {"sendInterval": "0s"}}.
- `sending_account_id` (`string`, optional): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.

Example input: `{"project_id":"<project_id>","scheduler":{}}`

### `glockapps_autotest_patch`

Update Automatic Test Note or Folder · Write

Change only an automatic test's note or folder.
Returns the updated autotest.
Use glockapps_autotest_patch for the note or folder. Use glockapps_autotest_update for anything else.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `autotest_id` (`string`, required): ID of the automatic test, from glockapps_autotests_short_list. Example: 6549fe4bf1d552cbdb5ef3a3.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `folder_id` (`string`, optional): Folder ID to move the autotest to. Use an empty string for the Home folder. Example: 64aff26141383479c220a619.
- `note` (`string`, optional): Free-text note shown with the item in GlockApps (autotest notes: up to 250 characters). Example: Weekly newsletter check.

Example input: `{"autotest_id":"<autotest_id>","project_id":"<project_id>"}`

### `glockapps_autotest_update`

Update Automatic Test · Write

Replace all editable settings of an automatic test: letter, connected mailbox, provider groups, schedule, send settings, folder, note and active status.
Returns the updated autotest.
Use glockapps_autotest_update for schedule or content changes; read the current settings with glockapps_autotest_get first. Use glockapps_autotest_patch for only the note or folder, and glockapps_autotests_bulk_update to switch many on or off.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `autotest_id` (`string`, required): ID of the automatic test, from glockapps_autotests_short_list. Example: 6549fe4bf1d552cbdb5ef3a3.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `scheduler` (`object`, required): Autotest schedule. Exactly one valid cron specification is required. An object with cronSpecs, a list holding exactly one cron specification such as "0 9 * * 1" or "@every 24h", and optionally startAt (RFC3339) and cronDescription (use "{}"). Example: {"cronSpecs": ["0 9 * * 1"], "startAt": "2026-06-11T14:25:00Z", "cronDescription": "{}"}.
- `sending_account_id` (`string`, required): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `active` (`boolean`, optional): Active status of the autotest. If set to true, the scheduler job is activated. Example: true.
- `folder_id` (`string`, optional): Autotest folder ID. If empty, the autotest is placed in the Home folder. Example: 64aff26141383479c220a619.
- `force_run` (`boolean`, optional): If true, runs the autotest immediately after update. Allowed only when active is true. Example: true.
- `letter_id` (`string`, optional): Saved Letter ID used by SMTP, Google, or Microsoft Automatic Tests. Omit for Klaviyo and HubSpot. Example: 6a2abf348fa8ec364101a803.
- `link_checker` (`boolean`, optional): Set true to check every link in the message. Example: true.
- `note` (`string`, optional): Free-text note shown with the item in GlockApps (autotest notes: up to 250 characters). Example: Weekly newsletter check.
- `notification_condition_ids` (`array`, optional): Notification condition IDs attached to the autotest. Example: ["5"].
- `provider_group_ids` (`array`, optional): Provider group IDs whose seed accounts receive the test, from glockapps_project_providers_list. Recommended over seed account IDs because GlockApps resolves the seeds at run time. Example: ["2", "3", "4"].
- `send_settings` (`object`, optional): Provider-specific delivery settings. Must match the selected Connected Mailbox type. Example: {"email": {"sendInterval": "0s"}}.

Example input: `{"autotest_id":"<autotest_id>","project_id":"<project_id>","scheduler":{},"sending_account_id":"<sending_account_id>"}`

### `glockapps_autotests_bulk_update`

Bulk Update Automatic Tests · Write

Activate, deactivate, run now or move many automatic tests at once, selected by ID and/or source folder.
Returns the result of the update. Running now (forceRun) spends one spam test credit per autotest.
Use glockapps_autotests_bulk_update to pause or resume several autotests. Use glockapps_autotest_update for one autotest's settings.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `autotest_ids` (`array`, optional): IDs of the autotests to update. Example: ["6549fe4bf1d552cbdb5ef3a3"].
- `changes` (`object`, optional): Fields to apply to every selected autotest: active (true to activate, false to pause), folderId to move them, and forceRun true to run them now. Example: {"active": false}.
- `source_folder_ids` (`array`, optional): IDs of the folders from which the autotests will be update, If an empty folder ID ("") is set, it represents the Home folder. Example: ["", "64aff26141383479c220a619"].

Example input: `{"project_id":"<project_id>"}`

### `glockapps_autotests_move`

Move Automatic Tests to Folder · Write

Move automatic tests into a folder, by autotest ID and/or every autotest in some source folders.
Returns the result of the move.
Use glockapps_autotests_move to file autotests. Use glockapps_autotest_patch to move one autotest.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `autotest_ids` (`array`, optional): IDs of individual autotests to move to the destination folder. Use this field when moving one autotest or several selected autotests. Example: ["6549fe4bf1d552cbdb5ef3a3"].
- `destination_folder_id` (`string`, optional): Destination folder ID. If empty, autotests will be moved to the Home folder. Example: 64aff26141383479c220a619.
- `source_folder_ids` (`array`, optional): IDs of source folders whose autotests should be moved to the destination folder. Use this field to move all autotests from one folder or several folders. If an empty folder ID ("") is set, it represents the Home folder. Example: ["", "64aff26141383479c220a619"].

Example input: `{"project_id":"<project_id>"}`

### `glockapps_connected_mailbox_proxy_email_generate`

Generate Connected Mailbox Proxy Email · Write

Generate a new proxy email address for a connected mailbox, replacing the current one (the old one is kept as prevProxyEmail).
Returns the mailbox with its new proxyEmail.
Use glockapps_connected_mailbox_proxy_email_generate only to rotate the address; senders must switch to the new one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `sending_account_id` (`string`, required): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.

Example input: `{"project_id":"<project_id>","sending_account_id":"<sending_account_id>"}`

### `glockapps_folder_create`

Create Folder · Write

Create a folder in a project for manual tests, autotests, proxy tests or Mailchimp tests.
Returns the new folder with its folderId.
Use glockapps_folder_create to organize test results. Use glockapps_test_reports_move or glockapps_autotests_move to file items into it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `folder_type` (`string`, required): Folder type (mandatory field), allowed values: "manualTestFolder", "autotestFolder", "proxyTestFolder", "mailchimpTestFolder". Example: manualTestFolder. One of: `manualTestFolder`, `autotestFolder`, `proxyTestFolder`, `mailchimpTestFolder`.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `name` (`string`, optional): Unique name of the folder, if empty - will be generated automatically; max length is 50 characters. Example: Q3 campaigns.

Example input: `{"folder_type":"manualTestFolder","project_id":"<project_id>"}`

### `glockapps_folder_update`

Rename Folder · Write

Rename a folder.
Returns the updated folder.
Use glockapps_folder_update to change a folder's name. Use glockapps_folder_delete to remove it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folder_id` (`string`, required): Folder ID. Example: 64aff26141383479c220a619.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `name` (`string`, optional): Unique name of the folder, if empty - will be generated automatically; max length is 50 characters. Example: Q4 campaigns.

Example input: `{"folder_id":"<folder_id>","project_id":"<project_id>"}`

### `glockapps_letter_raw_create`

Create Letter from Raw Email · Write

Save an email message to a project as a letter from its raw RFC 822 source (up to 10 MB).
Returns the new letter with its ID.
Use glockapps_letter_raw_create to add the message an automatic test or connected-mailbox send will use. Use glockapps_letters_list to see saved letters.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `raw_message` (`string`, required): The complete raw RFC 822 email message: headers (From, To, Subject, MIME-Version, Content-Type), a blank line, then the body. Maximum 10 MB. Example: From: News <news@example.com>
To: test@example.com
Subject: Q3 newsletter
MIM.

Example input: `{"project_id":"<project_id>","raw_message":"<raw_message>"}`

### `glockapps_manual_test_create`

Create Manual Spam Test · Write

Create a manual spam test, which spends one spam test credit (refunded if the test is deleted before any email arrives).
Returns the testId and the seed email addresses to send your message to.
Use glockapps_manual_test_create to test a campaign: send it to every returned seed address yourself, or with glockapps_manual_test_send through a connected mailbox. Read results with glockapps_test_report_get.
Call glockapps_project_providers_list first to choose providerGroupIds.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_type` (`string`, required): Type of test to create. Always ManualTest. Example: ManualTest. One of: `ManualTest`.
- `external_user_id` (`string`, optional): Your own identifier for the customer or user the test is for, stored with the test. Example: customer-42.
- `folder_id` (`string`, optional): Folder to store the test report in, from glockapps_folders_list (type manualTestFolder). An empty string or leaving it out uses the Home folder. Example: 64aff26141383479c220a619.
- `link_checker` (`boolean`, optional): Set true to check every link in the message. Example: true.
- `note` (`string`, optional): Free-text note shown with the item in GlockApps (autotest notes: up to 250 characters). Example: Weekly newsletter check.
- `provider_group_ids` (`array`, optional): Provider group IDs whose seed accounts receive the test, from glockapps_project_providers_list. Recommended over seed account IDs because GlockApps resolves the seeds at run time. Example: ["2", "3", "4"].
- `seed_account_group_ids` (`array`, optional): Seed account group IDs to include. Deprecated by GlockApps; use providerGroupIds. Example: ["10"].
- `seed_account_ids` (`array`, optional): Specific seed account IDs to include. Deprecated by GlockApps because seeds can be disabled automatically; use providerGroupIds. Example: ["101"].

Example input: `{"project_id":"<project_id>","test_type":"ManualTest"}`

### `glockapps_manual_test_send`

Send Manual Test via Connected Mailbox · Write

Send an existing manual test's message to its seed addresses through a connected mailbox (SMTP, Google, Microsoft, Klaviyo or HubSpot).
Returns the send status for the test.
Use glockapps_manual_test_send after glockapps_manual_test_create when the message should go out from a mailbox connected in GlockApps. Supply exactly one delivery object matching the mailbox type: mailbox (with a saved letterId), klaviyo, hubspotMarketingEmail or hubspotTransactionalEmail.
Connect the mailbox in the GlockApps app first; find its ID with glockapps_connected_mailboxes_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `sending_account_id` (`string`, required): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.
- `hubspot_marketing_email` (`object`, optional): For HubSpot Marketing Email: sourceMarketingEmailId (from the email's HubSpot URL) and allowSeedContactChanges true to let GlockApps create and subscribe the seed contacts. Example: {"sourceMarketingEmailId": "987654321", "allowSeedContactChanges": true}.
- `hubspot_transactional_email` (`object`, optional): For HubSpot Transactional Single-Send: sourceTransactionalEmailId and an optional sendInterval. Example: {"sourceTransactionalEmailId": "123456789", "sendInterval": "0"}.
- `klaviyo` (`object`, optional): For Klaviyo mailboxes: the sourceCampaignId to clone and an optional throttlePercentage (0 for none). Example: {"sourceCampaignId": "01HXYZ", "throttlePercentage": 0}.
- `mailbox` (`object`, optional): For Google, Microsoft or custom SMTP mailboxes: the saved letterId to send and an optional sendInterval such as 0s. Example: {"letterId": "6a2abf348fa8ec364101a803", "sendInterval": "0s"}.

Example input: `{"project_id":"<project_id>","sending_account_id":"<sending_account_id>","test_id":"<test_id>"}`

### `glockapps_project_autotest_email_generate`

Generate Project Autotest Email · Write

Generate a new autotest email address for a project, replacing the current one.
Returns the project's new autotest email address.
Use glockapps_project_autotest_email_generate only to rotate the address. Messages sent to the old address no longer reach the project.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_project_create`

Create Project · Write

Create a project to group spam tests, automatic tests, letters and connected mailboxes.
Returns the new project with its projectId.
Use glockapps_project_create for a new brand or client. Use glockapps_project_update to change an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the project. Example: Q3 newsletter.
- `blocklist_ids` (`array`, optional): Blocklist IDs used to filter out the blocklist servers for the test reports. This field is optional. If not set, the full list of blocklist servers will be used. Example: ["1", "2"].
- `description` (`string`, optional): Description of the project. Example: Deliverability tests for the marketing domain.
- `timezone` (`string`, optional): Timezone of the project, default is UTC. Example: UTC.

Example input: `{"name":"<name>"}`

### `glockapps_project_update`

Update Project · Write

Replace a project's name, description, timezone and blocklist selection.
Returns the updated project.
Use glockapps_project_update to rename a project or change which blocklists its reports check. Send every field you want to keep, since this replaces them.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `name` (`string`, required): Name of the project. Example: Q3 newsletter.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `blocklist_ids` (`array`, optional): Blocklist IDs used to filter out the blocklist servers for the test reports. This field is optional. If not set, the full list of blocklist servers will be used. Example: ["1", "2"].
- `description` (`string`, optional): Description of the project. Example: Deliverability tests for the marketing domain.
- `timezone` (`string`, optional): Timezone of the project, default is UTC. Example: UTC.

Example input: `{"name":"<name>","project_id":"<project_id>"}`

### `glockapps_test_report_update`

Update Test Report · Write

Change a test report's note, folder or meta data.
Returns the updated test report fields.
Use glockapps_test_report_update to annotate or file one test. Use glockapps_test_reports_move to move many tests at once.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `test_id` (`string`, required): ID of the spam test, from glockapps_manual_test_create or glockapps_test_results_short_list. Example: 2023-07-14-08:55:20:441t.
- `folder_id` (`string`, optional): Folder to move the test report to, from glockapps_folders_list. An empty string is the Home folder. Example: 64aff26141383479c220a619.
- `meta` (`string`, optional): Free-form metadata string stored with the test report. Example: {"campaign": "q3"}.
- `note` (`string`, optional): New note for the test report. Example: Weekly newsletter check.

Example input: `{"project_id":"<project_id>","test_id":"<test_id>"}`

### `glockapps_test_reports_move`

Move Test Reports to Folder · Write

Move test reports into a folder, by test ID and/or every report in some source folders.
Returns the result of the move.
Use glockapps_test_reports_move to file many reports at once. Use glockapps_test_report_update for one report's note or folder.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `destination_folder_id` (`string`, optional): Folder to move the reports into. An empty string moves them to the Home folder. Example: 64aff26141383479c220a619.
- `source_folder_ids` (`array`, optional): IDs of the folders from which the tests will be moved, If an empty folder ID ("") is set, it represents the Home folder. Example: ["", "64aff26141383479c220a619"].
- `test_ids` (`array`, optional): IDs of the tests to move to the destination folder. Example: ["2023-07-14-08:55:20:441t"].

Example input: `{"project_id":"<project_id>"}`

### `glockapps_autotest_delete`

Delete Automatic Test · Destructive

Delete an automatic test and stop its schedule.
Returns an empty object on success.
Use glockapps_autotest_delete to remove an autotest for good. Use glockapps_autotests_bulk_update with active false to pause it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `autotest_id` (`string`, required): ID of the automatic test, from glockapps_autotests_short_list. Example: 6549fe4bf1d552cbdb5ef3a3.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"autotest_id":"<autotest_id>","project_id":"<project_id>"}`

### `glockapps_connected_mailbox_delete`

Delete Connected Mailbox · Destructive

Delete a connected mailbox.
Returns an empty object on success. Fails while active autotests use the mailbox, unless force is true, which deactivates them.
Use glockapps_connected_mailbox_delete to disconnect a mailbox from GlockApps.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `sending_account_id` (`string`, required): ID of the connected mailbox, from glockapps_connected_mailboxes_list. Example: 6650c1f2a1b2c3d4e5f60718.
- `force` (`boolean`, optional): If true, active autotests associated with the connected mailbox are deactivated and the connected mailbox is deleted. Example: true.

Example input: `{"project_id":"<project_id>","sending_account_id":"<sending_account_id>"}`

### `glockapps_folder_delete`

Delete Folder · Destructive

Delete a folder.
Returns an empty object on success.
Use glockapps_folder_delete to remove a folder you no longer need. Move items you want to keep first with glockapps_test_reports_move or glockapps_autotests_move.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `folder_id` (`string`, required): Folder ID. Example: 64aff26141383479c220a619.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"folder_id":"<folder_id>","project_id":"<project_id>"}`

### `glockapps_letter_delete`

Delete Letter · Destructive

Delete a saved letter.
Returns an empty object on success.
Use glockapps_letter_delete to remove a letter no autotest needs any more.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `letter_id` (`string`, required): ID of the saved letter, from glockapps_letters_list. Example: 6a2abf348fa8ec364101a803.
- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"letter_id":"<letter_id>","project_id":"<project_id>"}`

### `glockapps_project_delete`

Delete Project · Destructive

Delete a project and everything in it.
Returns an empty object on success.
Use glockapps_project_delete only to remove a project for good. Use glockapps_project_update to change it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.

Example input: `{"project_id":"<project_id>"}`

### `glockapps_test_reports_delete`

Delete Test Reports · Destructive

Delete test reports by ID, or every report in the given folders.
Returns an empty object on success. Deleting a manual test before any email arrives refunds its credit.
Use glockapps_test_reports_delete to remove reports. Use glockapps_test_reports_move to file them instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the GlockApps project, from glockapps_projects_list. Example: 123456.
- `folder_id` (`string`, optional): Comma-separated folder IDs whose reports are all deleted; an empty string ("") is the Home folder. Leave unset to ignore folders. Example: 64aff26141383479c220a619.
- `ids` (`string`, optional): Test IDs to delete the test, separated by commas. Give ids, folderId or both. Example: 2023-07-14-08:55:20:441t.

Example input: `{"project_id":"<project_id>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
