# Smtp2go

SMTP2GO is a reliable email delivery service that ensures your emails reach recipients' inboxes efficiently.

- **Category:** transactional email
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 32
- **Triggers:** 0
- **Slug:** `SMTP2GO`
- **Version:** 20260211_00

## Tools

### Search Email Activity

**Slug:** `SMTP2GO_ACTIVITY_SEARCH`

Tool to search activity events like sends, opens, clicks, and bounces. Use when you need to filter account email activity by date, event, recipient, or message ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results to return, defaults to 100, maximum 1000 |
| `offset` | integer | No | Number of records to skip for pagination |
| `search` | object | No | Filter criteria for searching email activity. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Allowed Sender

**Slug:** `SMTP2GO_ALLOWED_SENDERS_ADD`

Tool to add a new allowed sender email address. Use when you need to whitelist a sender before sending email. Example: Add "user@example.com" to allowed senders list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_address` | string | Yes | Email address to add as an allowed sender. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Allowed Sender

**Slug:** `SMTP2GO_ALLOWED_SENDERS_REMOVE`

Tool to remove a sender email address from the allowed senders list. Use when you need to revoke send permissions for a validated address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_address` | string | Yes | The email address to remove from the allowed senders list |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Allowed Senders

**Slug:** `SMTP2GO_ALLOWED_SENDERS_UPDATE`

Tool to update (replace) the entire allowed senders list in your SMTP2GO account. This action overwrites the current list with the provided email addresses and domain names. Use when you need to set or update who can send emails through your account. Example: 'Update allowed senders to include user@example.com and admin@company.com in whitelist mode.'

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("whitelist" | "blacklist" | "disabled") | Yes | A string indicating how the list of email addresses and domain names is interpreted. 'whitelist' allows only listed senders, 'blacklist' blocks listed senders, 'disabled' turns off the feature. |
| `subaccount_id` | string | No | If you wish to make this API call on behalf of a subaccount then include its unique ID here. |
| `allowed_senders` | array | Yes | Array of email addresses and/or domain names that will be allowed to send emails through your account. This replaces the existing list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Allowed Senders

**Slug:** `SMTP2GO_ALLOWED_SENDERS_VIEW`

Tool to view the list of allowed senders configured in your account. Use after setting up SMTP2GO authentication to retrieve your allowed-senders list. Example: 'Show me all verified allowed senders.'

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Sender Domain

**Slug:** `SMTP2GO_DOMAIN_ADD`

Tool to add a new sender domain for SPF/DKIM verification. Use when you need to register a domain and optionally set tracking/return-path subdomains.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | The domain to add as a sending domain (top-level or subdomain). |
| `auto_verify` | boolean | No | If true, SMTP2GO will attempt to verify SPF/DKIM records automatically. |
| `subaccount_id` | string | No | Unique ID of the subaccount (if you manage multiple subaccounts). |
| `tracking_subdomain` | string | No | Subdomain for click/open tracking and unsubscribe links; defaults to 'link' if omitted. |
| `returnpath_subdomain` | string | No | Subdomain to use as the return-path (bounce) domain. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search SMTP2GO Emails

**Slug:** `SMTP2GO_EMAIL_SEARCH`

Tool to search sent emails. Use when filtering your SMTP2GO account's email activity by criteria like date, sender, or recipient. Call after authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event` | string | No | Filter only events matching this type (e.g., 'bounce', 'spam', etc.). |
| `limit` | integer | No | Number of results to return (default 100, max 500). |
| `offset` | integer | No | Pagination offset (default 0). |
| `sender` | string | No | Return only results for this specific sender email. |
| `status` | string | No | Return only results with this status (e.g., 'sent', 'dropped'). |
| `sort_by` | string | No | Sort returned items by this field. |
| `subject` | string | No | Return only results with this exact subject line. |
| `date_end` | string | No | End date (YYYY-MM-DD) for filtering results. |
| `email_id` | string | No | Return only results for this specific email ID. |
| `recipient` | string | No | Return only results for this specific recipient email. |
| `date_start` | string | No | Start date (YYYY-MM-DD) for filtering results. |
| `sort_order` | string ("asc" | "desc") | No | Order of returned results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add IP Allow List

**Slug:** `SMTP2GO_IP_ALLOW_LIST_ADD`

Tool to add a public IP address to your account's IP allow list. Use when you need to whitelist specific sending sources by IP after confirming accuracy. Note: Only plain IP addresses are supported (no CIDR notation). Private/reserved IP ranges are rejected.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | Public IP address to add to the allow list (e.g., '8.8.8.8'). Note: CIDR notation is NOT supported; use plain IP addresses only. Private/reserved IP ranges are not allowed. |
| `note` | string | No | Optional note for your reference (max 255 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove IP from Allow List

**Slug:** `SMTP2GO_IP_ALLOW_LIST_REMOVE`

Tool to remove an IP address from your account's IP allow list. Use after identifying the IP you wish to revoke.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip_address` | string | Yes | The IPv4 address to remove from the allow list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View IP Allow List

**Slug:** `SMTP2GO_IP_ALLOW_LIST_VIEW`

Tool to view the list of IP addresses in your IP allow list. Use after confirming your SMTP2GO API key is set.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Received SMS

**Slug:** `SMTP2GO_SMS_VIEW_RECEIVED`

Tool to retrieve received SMS replies for your SMTP2GO account. Use when you need to fetch incoming SMS messages for analysis or display. Pagination supported via limit and offset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of received SMS messages to return (default 100, max 500) |
| `offset` | integer | No | Number of messages to skip for pagination (default 0) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Email Bounces Stats

**Slug:** `SMTP2GO_STATS_EMAIL_BOUNCES`

Tool to retrieve email bounces statistics. Use after sending emails to analyze bounce metrics over a time period.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Filter results by a specific email address |
| `limit` | integer | No | Number of records to return, defaults to API default |
| `offset` | integer | No | Record offset for pagination, defaults to API default |
| `date_end` | string | No | End date (inclusive) in YYYY-MM-DD format to filter bounces |
| `date_start` | string | No | Start date (inclusive) in YYYY-MM-DD format to filter bounces |
| `sort_field` | string | No | Field by which to sort results, e.g., date_bounced |
| `sort_direction` | string ("ASC" | "DESC") | No | Sort direction for results, either ASC or DESC |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Cycle Statistics

**Slug:** `SMTP2GO_STATS_EMAIL_CYCLE`

Tool to retrieve current email cycle/quota statistics. Use when you need to check the account's monthly email allowance, usage, and remaining quota for the current billing cycle.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email History Statistics

**Slug:** `SMTP2GO_STATS_EMAIL_HISTORY`

Tool to retrieve email history statistics. Use when you need detailed delivery metrics within a date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Filter results by message tag. |
| `email` | string | No | Filter results by recipient email address. |
| `limit` | integer | No | Maximum number of records to return (1–1000). |
| `offset` | integer | No | Number of records to skip for pagination. |
| `sender` | string | No | Filter results by sender email address. |
| `date_end` | string | No | End date for filtering (YYYY-MM-DD). |
| `date_start` | string | No | Start date for filtering (YYYY-MM-DD). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Spam Statistics

**Slug:** `SMTP2GO_STATS_EMAIL_SPAM`

Tool to retrieve email spam report statistics. Use when analyzing spam trends for sent emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of records to return (default 100, max 1000). |
| `offset` | integer | No | Pagination offset (default 0). |
| `sender` | string | No | Filter results by sender email address. |
| `date_end` | string | Yes | End date (YYYY-MM-DD) for filtering spam statistics. |
| `recipient` | string | No | Filter results by recipient email address. |
| `date_start` | string | Yes | Start date (YYYY-MM-DD) for filtering spam statistics. |
| `transaction_id` | string | No | Filter results by transaction ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Unsubscription Stats

**Slug:** `SMTP2GO_STATS_EMAIL_UNSUBS`

Tool to retrieve email unsubscribe statistics. Use when you need unsubscribe data for your account over a date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date_end` | string | No | Ending date (YYYY-MM-DD) for the unsubscribe report. |
| `date_start` | string | No | Starting date (YYYY-MM-DD) for the unsubscribe report. |
| `result_limit` | integer | No | Maximum number of records to return (1-1000). |
| `email_address` | string | No | Restrict results to this email address. |
| `result_offset` | integer | No | Number of records to skip for pagination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Subaccounts

**Slug:** `SMTP2GO_SUBACCOUNTS_SEARCH`

Tool to search subaccounts. Use after authenticating to filter and paginate your subaccounts by name, email, or status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter results to subaccounts with this name. |
| `email` | string | No | Filter results to subaccounts with this email address. |
| `limit` | integer | No | Number of records to return (default 100, max 1000). |
| `active` | boolean | No | Filter results by active status (true or false). |
| `offset` | integer | No | Number of records to skip for pagination (default 0). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Subaccounts Usage

**Slug:** `SMTP2GO_SUBACCOUNTS_USAGE`

Tool to retrieve usage statistics for subaccounts. Use when you need to monitor per-subaccount email usage.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subaccount_id` | string | No | ID of the subaccount for which to retrieve usage statistics. If omitted, statistics for all subaccounts are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add to Suppression List

**Slug:** `SMTP2GO_SUPPRESSION_ADD`

Tool to add email addresses or domains to the suppression list. Use when you need to block sending emails to specific recipients or entire domains after unsubscribes or bounces.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("EMAIL" | "DOMAIN" | "ALL") | No | Type of suppression: EMAIL to suppress addresses, DOMAIN to suppress domains, ALL for both. |
| `description` | string | No | Optional note about the suppression reason. |
| `email_address` | string | Yes | A valid RFC-5322 formatted email address to add to the suppression list. Email addresses added to the suppression list will be blocked from receiving future emails. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove suppression entry

**Slug:** `SMTP2GO_SUPPRESSION_REMOVE`

Tool to remove an email address or domain from the suppression list. Use when you want to resume sending to the address or domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address to remove from suppression list. |
| `domain` | string | No | Domain to remove from suppression list. |
| `subaccount_id` | string | No | Subaccount ID from which to remove suppression entry. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Suppression List

**Slug:** `SMTP2GO_SUPPRESSION_VIEW`

Tool to view the suppression list. Use when you need to inspect suppressed email addresses in your account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (default 100) |
| `offset` | integer | No | Number of results to skip for pagination |
| `end_date` | string | No | Only list suppressions added on or before this date (YYYY-MM-DD) |
| `start_date` | string | No | Only list suppressions added on or after this date (YYYY-MM-DD) |
| `email_address` | string | No | Filter by specific email address |
| `suppression_type` | string ("bounces" | "unsubscribes" | "spam complaints") | No | Type of suppression to filter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Email Template

**Slug:** `SMTP2GO_TEMPLATE_EDIT`

Tool to edit details of an existing email template. Use when you need to update template properties after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the template |
| `subject` | string | No | New subject line for the template |
| `html_body` | string | No | New HTML content for the template |
| `text_body` | string | No | New plain text content for the template |
| `editor_code` | string | No | New code view content for drag-and-drop editor templates |
| `is_archived` | boolean | No | Whether to archive (true) or unarchive (false) the template |
| `template_id` | string | Yes | ID of the template to edit |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Email Templates

**Slug:** `SMTP2GO_TEMPLATE_SEARCH`

Tool to search your collection of email templates by ID or name. Use when you need to find templates matching specific criteria after authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter by the template name. |
| `limit` | integer | No | Number of results per page (1-1000). |
| `offset` | integer | No | Number of results to skip for pagination. |
| `template_id` | string | No | Filter by the unique template identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Email Template

**Slug:** `SMTP2GO_TEMPLATE_VIEW`

Tool to view details of a specific email template. Use after you have the template ID to inspect.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | ID of the email template to view |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add SMTP User

**Slug:** `SMTP2GO_USERS_SMTP_ADD`

Tool to add a new SMTP user. Use when you need to provision a fresh SMTP credential after collecting username and password.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_data` | object | Yes | The SMTP user details to add |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit SMTP User

**Slug:** `SMTP2GO_USERS_SMTP_EDIT`

Tool to edit details of an existing SMTP user. Use when you need to update username, password, sender restrictions, or enable/disable a user after confirming the target username.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `disabled` | boolean | No | If true, disables this SMTP user entirely. |
| `password` | string | No | New password for the SMTP user (minimum 8 characters). |
| `username` | string | Yes | The existing SMTP username to edit. |
| `allowed_ips` | array | No | List of IP addresses permitted for this SMTP user. Omit or pass an empty list to allow any IP. |
| `reset_stats` | boolean | No | If true, resets all usage statistics for this SMTP user. |
| `new_username` | string | No | New SMTP username if you wish to change it. |
| `allow_senders` | array | No | List of specific email addresses this SMTP user is allowed to send from. Omit or pass an empty list to allow any sender. |
| `sender_domain` | string | No | Restrict sending to this domain only (e.g., 'example.com'). |
| `disable_senders` | boolean | No | If true, disables all senders for this SMTP user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove SMTP User

**Slug:** `SMTP2GO_USERS_SMTP_REMOVE`

Tool to remove an SMTP user from your account. Use when you need to revoke SMTP access for a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | Yes | SMTP username to remove, typically an email address or SMTP user ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View SMTP Users

**Slug:** `SMTP2GO_USERS_SMTP_VIEW`

Tool to list all SMTP users configured on your account. Use when you need to retrieve SMTP user configurations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Webhook

**Slug:** `SMTP2GO_WEBHOOK_ADD`

Tool to create a new webhook. Use when you need real-time notifications of email or SMS events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional human-readable name for the webhook. |
| `events` | array | Yes | List of event types to trigger this webhook. |
| `webhook_url` | string | Yes | The destination URL where SMTP2GO will send event notifications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Webhook

**Slug:** `SMTP2GO_WEBHOOK_EDIT`

Tool to edit an existing webhook’s settings. Use when you need to update a webhook's configuration after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Destination URL where SMTP2GO will POST webhook events (required for every edit) |
| `users` | array | No | List of SMTP2GO user IDs for which this webhook should fire |
| `sms_events` | array | No | List of SMS events that will trigger this webhook |
| `webhook_id` | string | Yes | Unique identifier of the webhook to be edited (integer ID as string) |
| `output_type` | string ("json" | "form") | No | Format of the webhook payload |
| `email_events` | array | Yes | List of email events that will trigger this webhook. Valid events: bounce, unsubscribe, spam, transactional, click, open, delivered. At least one event is required. |
| `email_headers` | array | No | Custom email headers to include in the webhook payload |
| `authorization_header` | string | No | Custom authorization header to include with each webhook request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove webhook

**Slug:** `SMTP2GO_WEBHOOK_REMOVE`

Tool to remove a webhook. Use when you want to delete a webhook by its ID from your SMTP2GO account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to remove |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Webhooks

**Slug:** `SMTP2GO_WEBHOOK_VIEW`

Tool to view all webhooks configured in your account. Use when you need to inspect existing webhook configurations after setup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subaccount_id` | string | No | ID of the subaccount to retrieve webhooks for. If omitted, retrieves webhooks for the main account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |