First-party app
Elastic Email

Elastic Email

Send transactional and bulk email through Elastic Email, and manage its contacts, lists, templates, campaigns, suppressions and statistics.

stable EmailCommunication

About

Elastic Email ships in the w6w first-party pack. It declares 20 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.elastic-email
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Email · Communication

Overview

Elastic Email is an email delivery and email marketing platform. This app connects a workflow to an Elastic Email account over its v4 API.

Send a transactional email (to, cc, bcc, HTML and plain-text bodies, merge fields, a stored template, attachments already uploaded to the account) or a bulk merge send with per-recipient fields, then follow the delivery with the transaction status. Add, read, list and delete contacts, manage lists and their members, browse templates and campaigns, review and clear suppressions, and read account-wide send statistics.

Connect with an API key from Settings > Manage API Keys; the key’s access level decides which actions it may run.

Build with Elastic Email

Three routes to the same 20 actions. The Workflow tab is generated from Elastic Email's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Campaign

campaign-get

Load one campaign by name: status, content, recipients and options.

List Campaigns

campaign-list

List campaigns, optionally filtered by a name fragment. Limited to 1000 results.

Add Contact

contact-add

Add a contact, optionally into one or more lists. Elastic Email's endpoint takes an array and answers the stored contacts; this sends one and returns it.

Delete Contact

contact-delete

Permanently delete a contact by email address.

Get Contact

contact-get

Load one contact by email address, with status, custom fields and send activity.

List Contacts

contact-list

List contacts in the account, page by page.

Send Email

email-send

Send one transactional email. To, CC and BCC recipients all receive the same message and the To/CC addresses see each other. Use Send Bulk Email for per-recipient merge sends.

Send Bulk Email

email-send-bulk

Send a merge email to many recipients. Each recipient receives a separate message, personalised with their own `fields`, and cannot see the others.

Get Email Status

email-status

Delivery status of a send, by the TransactionID a send action returned: counts of sent, delivered, opened, clicked, bounced and unsubscribed, plus the addresses behind each when the matching option is switched on.

Add Contacts to List

list-add-contacts

Add EXISTING contacts to a list, by email or by a segment rule. Unknown emails are not created; use Add Contact for that.

List Contacts in List

list-contacts

List the contacts that belong to one list.

Create List

list-create

Create a contact list, optionally seeded with existing contacts.

List Lists

list-list

List the account's contact lists (name, public id, date added).

Remove Contacts from List

list-remove-contacts

Remove contacts from a list (the contacts themselves are kept), by email or by a segment rule.

Get Statistics

statistics-get

Account-wide send statistics between two dates.

Delete Suppression

suppression-delete

Remove an address from the suppression list so it can be mailed again.

Get Suppression

suppression-get

Look up why one address is suppressed (error code, friendly message, date).

List Suppressions

suppression-list

List suppressed addresses (bounces, complaints, unsubscribes) with the reason.

Get Template

template-get

Load one template by name, including its body parts and subject.

List Templates

template-list

List email templates of one or both scopes (Personal, Global).

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Elastic Email's real ids.

{
  "manifestVersion": "2",
  "name": "elastic-email-example",
  "steps": [
    {
      "id": "campaign-get",
      "uses": {
        "app": "io.w6w.elastic-email",
        "action": "campaign-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "name": "<name>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Campaign

    read
    campaign-get
  • List Campaigns

    search
    campaign-list
  • Add Contact

    perform
    contact-add
  • Get Contact

    read
    contact-get
  • List Contacts

    search
    contact-list

+15 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Elastic Email, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Elastic Email. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "campaign-get",
  payload: {
    name: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action campaign-get --payload '{"name":"<value>"}'

Give an AI agent Elastic Email — without giving it Elastic Email's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.elastic-email#campaign-get",
    "input": {
      "name": "<name>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Elastic Email connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Elastic Email's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Elastic Email itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Elastic Email declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Elastic Email platform status

The `API.ELASTICEMAIL.COM` component on Elastic Email's Statuspage. The web app, SMTP and inbound components are reported as detail but never drive the verdict.

dependency

API reachable

Unauthenticated GET https://api.elasticemail.com/v4/statistics. HTTP 400 with Elastic Email's JSON `{"Error": …}` passes — it proves the API and its auth layer are answering. Credential validity is the derived `auth:*` check's job.

quota

Quota headroom