> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/smtp2go.md).

# SMTP2GO

Integration with SMTP2GO for sending transactional email, managing suppressions and templates, tracking delivery activity and statistics, and reacting to bounce, engagement and unsubscribe webhooks.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| SMTP2GO   | API Key        |

### SMTP2GO

Connect to SMTP2GO to send transactional email, manage suppressions and templates, and track delivery activity and statistics. The API key must have every endpoint you plan to use enabled in SMTP2GO under Sending > API Keys, or those calls fail with an endpoint-permission error even though the key itself is valid.

#### Set up in SMTP2GO

1. Prepare the SMTP2GO account or service that the workflow will access. Grant access to the required resources and operations.
2. **API Key:** Create a key in SMTP2GO under Sending > API Keys. A key only works for the endpoints its permissions were enabled for at creation, so also enable permission for every endpoint this integration's actions use (sending, activity, suppressions, templates, statistics, webhooks) -- otherwise those calls fail with an endpoint-permission error even though the key itself is valid.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **SMTP2GO**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key       | Yes      | Create a key in SMTP2GO under Sending > API Keys. A key only works for the endpoints its permissions were enabled for at creation, so also enable permission for every endpoint this integration's actions use (sending, activity, suppressions, templates, statistics, webhooks) -- otherwise those calls fail with an endpoint-permission error even though the key itself is valid. [Provider instructions](https://developers.smtp2go.com/docs/getting-started). |

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **SMTP2GO** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Send Email

Send an email to one or more recipients with your own subject and body.

#### Inputs

| Field            | Type            | Required | Description                                                                                                                                                                                       |
| ---------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| From             | select (string) | Yes      | The address the email is sent from. It must already be verified in your SMTP2GO account, either as a single sender or under a verified sending domain. Options load from the selected connection. |
| To               | string          | Yes      | Who receives the email. Separate multiple addresses with commas, up to 100.                                                                                                                       |
| Subject          | string          | Yes      | The subject line recipients see.                                                                                                                                                                  |
| HTML body        | textarea        | No       | The rich HTML version of the message. Provide this, the plain text body, or both.                                                                                                                 |
| Plain text body  | textarea        | No       | The plain text version of the message, used by clients that cannot show HTML. Provide this, the HTML body, or both.                                                                               |
| Advanced options | boolean         | No       | Show optional Cc, Bcc, reply-to, attachment, and scheduling settings. Default: false.                                                                                                             |
| Cc               | string          | No       | Addresses to copy on the email, visible to every recipient. Separate with commas.                                                                                                                 |
| Bcc              | string          | No       | Addresses to copy privately. Other recipients cannot see them. Separate with commas.                                                                                                              |
| Reply-To         | string          | No       | Where replies should go, if that is different from the From address.                                                                                                                              |
| Attachment URLs  | string          | No       | Publicly reachable links to files you want attached. SMTP2GO downloads each one and attaches it. Separate with commas.                                                                            |
| Send at          | datetime        | No       | Hold the email and send it at this time instead of immediately. Must be within the next 3 days and include a timezone offset.                                                                     |

#### Outputs

| Field           | Type          | Description                                                                               |
| --------------- | ------------- | ----------------------------------------------------------------------------------------- |
| Email ID        | string        | The SMTP2GO identifier for this email, usable to look up its delivery activity later.     |
| Succeeded       | integer       | How many emails were accepted for delivery.                                               |
| Failed          | integer       | How many emails were rejected. Anything above zero means part of the send did not go out. |
| Failure details | string\_array | The reason each rejected email was not sent.                                              |
| Schedule ID     | string        | Set only when the email was scheduled. Identifies the queued send.                        |

### Send Template Email

Send an email built from one of your saved SMTP2GO templates, filling in its variables.

#### Inputs

| Field              | Type            | Required | Description                                                                                                                         |
| ------------------ | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Template           | select (string) | Yes      | Which saved template to send. Options load from the selected connection.                                                            |
| From               | select (string) | Yes      | The address the email is sent from. It must already be verified in your SMTP2GO account. Options load from the selected connection. |
| To                 | string          | Yes      | Who receives the email. Separate multiple addresses with commas, up to 100.                                                         |
| Template variables | textarea        | No       | Values for the placeholders in the template, as a JSON object of name and value pairs.                                              |
| Cc                 | string          | No       | Addresses to copy on the email, visible to every recipient. Separate with commas.                                                   |
| Bcc                | string          | No       | Addresses to copy privately. Other recipients cannot see them. Separate with commas.                                                |
| Reply-To           | string          | No       | Where replies should go, if that is different from the From address.                                                                |
| Send at            | datetime        | No       | Hold the email and send it at this time instead of immediately. Must be within the next 3 days and include a timezone offset.       |

#### Outputs

| Field           | Type          | Description                                                                               |
| --------------- | ------------- | ----------------------------------------------------------------------------------------- |
| Email ID        | string        | The SMTP2GO identifier for this email, usable to look up its delivery activity later.     |
| Succeeded       | integer       | How many emails were accepted for delivery.                                               |
| Failed          | integer       | How many emails were rejected. Anything above zero means part of the send did not go out. |
| Failure details | string\_array | The reason each rejected email was not sent.                                              |
| Schedule ID     | string        | Set only when the email was scheduled. Identifies the queued send.                        |

### Block Recipient

Stop SMTP2GO from delivering to an address or a whole domain by adding it to your suppression list.

#### Inputs

| Field             | Type   | Required | Description                                                                                    |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| Address or domain | string | Yes      | The email address to block. Enter a bare domain instead to block every address at that domain. |
| Reason            | string | No       | A note explaining why this recipient was blocked, shown alongside the entry in SMTP2GO.        |

#### Outputs

| Field             | Type    | Description                                                                    |
| ----------------- | ------- | ------------------------------------------------------------------------------ |
| Address or domain | string  | The address or domain that was blocked.                                        |
| Added             | boolean | Whether a new suppression was created. False means it was already on the list. |
| Reason            | string  | The note stored with the suppression.                                          |

### Unblock Recipient

Remove an address or domain from your suppression list so SMTP2GO can deliver to it again.

#### Inputs

| Field                | Type            | Required | Description                                                                                                                                                                                                                                                                                             |
| -------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Address or domain    | string          | Yes      | The blocked email address or domain you want to start delivering to again.                                                                                                                                                                                                                              |
| Block types to clear | select (string) | No       | Which kind of block to lift. Manual blocks are ones someone added by hand. Spam and unsubscribe blocks record a recipient opting out, so clear those only when the recipient has asked to be re-subscribed. Available values: Manual, Bounce, Spam complaint, Unsubscribe, Compliance. Default: manual. |

#### Outputs

| Field              | Type    | Description                                                                         |
| ------------------ | ------- | ----------------------------------------------------------------------------------- |
| Address or domain  | string  | The address or domain the unblock applied to.                                       |
| Removed            | boolean | Whether a suppression was actually lifted. False means there was no matching block. |
| Block type cleared | string  | The kind of block that was lifted.                                                  |

### List Blocked Recipients

See which addresses and domains SMTP2GO is currently refusing to deliver to, and why.

#### Inputs

| Field                    | Type            | Required | Description                                                                                                                                                                                        |
| ------------------------ | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Check a specific address | string          | No       | Check whether one address or domain is blocked. An empty result means it is deliverable, not that the lookup failed. Leave blank to browse everything.                                             |
| Block type               | select (string) | No       | Show only one kind of block, such as bounces or spam complaints. Leave empty for all kinds. Available values: Manual, Spam complaint, Unsubscribe, Bounce, Compliance.                             |
| From                     | datetime        | No       | Only show recipients blocked on or after this time. IMPORTANT: SMTP2GO defaults this to 30 days ago, not all time, so an address blocked further back will not appear unless you widen this range. |
| To                       | datetime        | No       | Only show recipients blocked on or before this time. Defaults to now.                                                                                                                              |
| Maximum results          | integer         | No       | How many blocked recipients to return at most. Minimum: 1. Default: 100.                                                                                                                           |
| Continue from            | string          | No       | Paste the continue token from a previous run to fetch the next batch.                                                                                                                              |

#### Outputs

| Field              | Type          | Description                                                                                   |
| ------------------ | ------------- | --------------------------------------------------------------------------------------------- |
| Blocked recipients | object\_array | The blocked entries, each with the address, the block type, the note and when it was blocked. |
| Continue token     | string        | Present when more results are available. Feed it back in to get the next batch.               |
| Total matches      | integer       | How many entries match the filters in total, across all pages.                                |

### Search Email Activity

Look up what happened to your sent emails: delivered, bounced, opened, clicked or marked as spam.

#### Inputs

| Field                       | Type            | Required | Description                                                                                                                                                                                                                   |
| --------------------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Email ID                    | string          | No       | Track one specific email by the ID returned when it was sent.                                                                                                                                                                 |
| Recipient contains          | string          | No       | Show only emails sent to addresses containing this text.                                                                                                                                                                      |
| Event type                  | select (string) | No       | Show only one kind of event, such as bounces or opens. Leave empty for all events. Available values: Processed, Delivered, Opened, Clicked, Soft bounced, Hard bounced, Rejected, Marked as spam, Unsubscribed, Resubscribed. |
| Sender contains             | string          | No       | Show only emails sent from addresses containing this text.                                                                                                                                                                    |
| Subject contains            | string          | No       | Show only emails whose subject contains this text.                                                                                                                                                                            |
| From                        | datetime        | No       | Only show events on or after this time. If left blank, SMTP2GO defaults to midnight today UTC, not all time, so a search for older mail with no date set comes back empty.                                                    |
| To                          | datetime        | No       | Only show events on or before this time. Defaults to now.                                                                                                                                                                     |
| Latest event per email only | boolean         | No       | Return just the most recent event for each email instead of its full history. Useful for a current-status list. Default: false.                                                                                               |
| Maximum results             | integer         | No       | How many events to return at most. SMTP2GO allows up to 1000. Minimum: 1. Maximum: 1000. Default: 100.                                                                                                                        |
| Continue from               | string          | No       | Paste the continue token from a previous run to fetch the next batch.                                                                                                                                                         |

#### Outputs

| Field          | Type          | Description                                                                                             |
| -------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
| Events         | object\_array | The matching delivery events, each with the recipient, subject, event type, time and any bounce reason. |
| Continue token | string        | Present when more results are available. Feed it back in to get the next batch.                         |
| Total matches  | integer       | How many events match in total, across all pages.                                                       |

### Create Email Template

Save a reusable email template with placeholders you can fill in each time you send.

#### Inputs

| Field           | Type     | Required | Description                                                                                      |
| --------------- | -------- | -------- | ------------------------------------------------------------------------------------------------ |
| Template ID     | string   | Yes      | A short, unique, case-sensitive code you will use to refer to this template, 5 to 24 characters. |
| Template name   | string   | Yes      | A readable name for this template, shown when browsing your templates. Up to 64 characters.      |
| Subject         | string   | Yes      | The subject line, which can include placeholders such as {{ first\_name }}.                      |
| HTML body       | textarea | Yes      | The rich HTML version of the template, which can include placeholders such as {{ first\_name }}. |
| Plain text body | textarea | Yes      | The plain text version of the template, used by clients that cannot show HTML.                   |
| Tags            | string   | No       | Labels to group this template with others, so you can find it later. Separate with commas.       |

#### Outputs

| Field         | Type     | Description                              |
| ------------- | -------- | ---------------------------------------- |
| Template ID   | string   | The id of the template that was created. |
| Template name | string   | The readable name of the template.       |
| Subject       | string   | The subject line stored on the template. |
| Last updated  | datetime | When the template was last changed.      |

### List Email Templates

Browse the email templates saved in your SMTP2GO account.

#### Inputs

| Field           | Type    | Required | Description                                                                                     |
| --------------- | ------- | -------- | ----------------------------------------------------------------------------------------------- |
| Search          | string  | No       | Find templates whose name, ID, subject or tags contain this text. Leave empty to list them all. |
| Tags            | string  | No       | Show only templates carrying any of these tags. Separate with commas.                           |
| Maximum results | integer | No       | How many templates to return at most. Minimum: 1. Default: 100.                                 |
| Continue from   | string  | No       | Paste the continue token from a previous run to fetch the next batch.                           |

#### Outputs

| Field          | Type          | Description                                                                     |
| -------------- | ------------- | ------------------------------------------------------------------------------- |
| Templates      | object\_array | The matching templates, each with its ID, name, subject and tags.               |
| Continue token | string        | Present when more results are available. Feed it back in to get the next batch. |

### Get Email Statistics

Get the headline numbers for your account: how many emails were sent, opened, clicked, bounced or marked as spam, plus how much of your plan you have used.

#### Inputs

| Field     | Type   | Required | Description                                                                     |
| --------- | ------ | -------- | ------------------------------------------------------------------------------- |
| SMTP user | string | No       | Limit the figures to a single SMTP username. Leave empty for the whole account. |

#### Outputs

| Field                | Type    | Description                                                                                 |
| -------------------- | ------- | ------------------------------------------------------------------------------------------- |
| Emails sent          | integer | How many emails were sent in the current billing cycle.                                     |
| Opens                | integer | How many times recipients opened your emails.                                               |
| Clicks               | integer | How many times recipients clicked a link.                                                   |
| Hard bounces         | integer | Permanent delivery failures, usually an address that does not exist.                        |
| Soft bounces         | integer | Temporary delivery failures, such as a full mailbox.                                        |
| Spam complaints      | integer | How many recipients marked your email as spam.                                              |
| Unsubscribes         | integer | How many recipients opted out.                                                              |
| Bounce rate          | string  | Bounces as a share of emails sent. Above a few percent usually means list hygiene problems. |
| Spam rate            | string  | Spam complaints as a share of emails sent.                                                  |
| Plan quota used      | integer | How many of your plan's emails you have used this cycle.                                    |
| Plan quota remaining | integer | How many emails you have left this cycle before hitting your plan limit.                    |
| Cycle ends           | string  | When the current billing cycle resets.                                                      |

### Get Email History

Break down sending performance over a date range, grouped by domain, sender address, SMTP user or subaccount.

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                 |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Group by | select (string) | No       | How to break the numbers down: by recipient domain, by sending address, by SMTP user or by subaccount. Available values: Domain, Email address, SMTP username, Subaccount. Default: domain. |
| From     | datetime        | No       | Start of the period to report on. Defaults to 30 days ago.                                                                                                                                  |
| To       | datetime        | No       | End of the period to report on. Defaults to now.                                                                                                                                            |

#### Outputs

| Field               | Type          | Description                                                                                                  |
| ------------------- | ------------- | ------------------------------------------------------------------------------------------------------------ |
| Breakdown           | object\_array | One row per group, each with emails sent, opens, clicks, bounces, spam, unsubscribes and the matching rates. |
| Total emails        | integer       | Total emails sent across the whole period.                                                                   |
| Overall bounce rate | number        | Bounces as a share of all emails sent in the period.                                                         |
| Overall open rate   | number        | Opens as a share of all emails sent in the period.                                                           |

## Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

### Email Delivery Failed

Fires when SMTP2GO cannot deliver an email or the recipient reports it as spam, so you can clean your list or alert someone.

StackAI registers and secures the SMTP2GO webhook automatically when you enable this trigger; no setup is needed in the SMTP2GO dashboard. SMTP2GO allows 1 webhook on a free account and 10 on a paid one, counted across your whole account, so enabling more of these triggers than your plan allows will fail to register.

#### Configuration

| Field           | Type   | Required | Description                                                                                    |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| Only for sender | string | No       | Only fire for emails sent from this address. Leave empty to watch every sender on the account. |

#### Event inputs

| Field       | Type   | Required | Description                                                                  |
| ----------- | ------ | -------- | ---------------------------------------------------------------------------- |
| Event type  | string | Yes      | Which failure occurred: bounce, reject or spam.                              |
| Email ID    | string | Yes      | The identifier of the email that failed, usable to look up its full history. |
| Recipient   | string | Yes      | The address that could not be reached.                                       |
| Sender      | string | No       | The address the email was sent from.                                         |
| Subject     | string | No       | The subject line of the email that failed.                                   |
| Reason      | string | No       | Why the delivery failed, as reported by the receiving mail server.           |
| Occurred at | string | No       | When the failure happened.                                                   |

#### Outputs

| Field       | Type     | Description                                                                  |
| ----------- | -------- | ---------------------------------------------------------------------------- |
| Event type  | string   | Which failure occurred: bounce, reject or spam.                              |
| Email ID    | string   | The identifier of the email that failed, usable to look up its full history. |
| Recipient   | string   | The address that could not be reached.                                       |
| Sender      | string   | The address the email was sent from.                                         |
| Subject     | string   | The subject line of the email that failed.                                   |
| Reason      | string   | Why the delivery failed, as reported by the receiving mail server.           |
| Occurred at | datetime | When the failure happened.                                                   |

### Email Opened or Clicked

Fires when a recipient opens one of your emails or clicks a link in it, so you can follow up while their interest is fresh.

StackAI registers and secures the SMTP2GO webhook automatically when you enable this trigger; no setup is needed in the SMTP2GO dashboard. SMTP2GO allows 1 webhook on a free account and 10 on a paid one, counted across your whole account, so enabling more of these triggers than your plan allows will fail to register. Note that SMTP2GO does not report which link was clicked, so the destination URL is not available on click events.

#### Configuration

| Field           | Type   | Required | Description                                                                                    |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| Only for sender | string | No       | Only fire for emails sent from this address. Leave empty to watch every sender on the account. |

#### Event inputs

| Field       | Type   | Required | Description                                               |
| ----------- | ------ | -------- | --------------------------------------------------------- |
| Event type  | string | Yes      | Whether the recipient opened the email or clicked a link. |
| Email ID    | string | Yes      | The identifier of the email that was engaged with.        |
| Recipient   | string | Yes      | The person who opened or clicked.                         |
| Subject     | string | No       | The subject line of the email they engaged with.          |
| Occurred at | string | No       | When the open or click happened.                          |

#### Outputs

| Field       | Type     | Description                                               |
| ----------- | -------- | --------------------------------------------------------- |
| Event type  | string   | Whether the recipient opened the email or clicked a link. |
| Email ID    | string   | The identifier of the email that was engaged with.        |
| Recipient   | string   | The person who opened or clicked.                         |
| Subject     | string   | The subject line of the email they engaged with.          |
| Occurred at | datetime | When the open or click happened.                          |

### Recipient Unsubscribed

Fires when a recipient opts out of your emails, so you can record the opt-out in your own systems straight away.

StackAI registers and secures the SMTP2GO webhook automatically when you enable this trigger; no setup is needed in the SMTP2GO dashboard. SMTP2GO allows 1 webhook on a free account and 10 on a paid one, counted across your whole account, so enabling more of these triggers than your plan allows will fail to register. SMTP2GO suppresses the address on its side too, so this trigger is for mirroring the opt-out into your own systems.

#### Event inputs

| Field       | Type   | Required | Description                                                  |
| ----------- | ------ | -------- | ------------------------------------------------------------ |
| Email ID    | string | Yes      | The identifier of the email the recipient unsubscribed from. |
| Recipient   | string | Yes      | The address that opted out.                                  |
| Sender      | string | No       | The address the email was sent from.                         |
| Subject     | string | No       | The subject line of the email they unsubscribed from.        |
| Occurred at | string | No       | When the recipient opted out.                                |

#### Outputs

| Field       | Type     | Description                                                  |
| ----------- | -------- | ------------------------------------------------------------ |
| Email ID    | string   | The identifier of the email the recipient unsubscribed from. |
| Recipient   | string   | The address that opted out.                                  |
| Sender      | string   | The address the email was sent from.                         |
| Subject     | string   | The subject line of the email they unsubscribed from.        |
| Occurred at | datetime | When the recipient opted out.                                |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/smtp2go.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
