# Unione

UniOne is an email delivery service offering a versatile Web API and SMTP API for sending transactional and marketing emails.

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

## Tools

### Delete Event Dump

**Slug:** `UNIONE_DELETE_EVENT_DUMP`

Tool to delete an event dump file and remove it from the queue or storage. Use when you need to clean up an existing event dump by its dump_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dump_id` | string | Yes | Event dump ID to delete. |

#### 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 |

### Delete Template

**Slug:** `UNIONE_DELETE_TEMPLATE`

Tool to delete a template by ID. Use when you need to permanently remove a template from the account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Template UUID to delete. Must be a valid 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 |

### Delete Webhook

**Slug:** `UNIONE_DELETE_WEBHOOK`

Tool to delete a webhook event notification handler by its URL. Use when you need to stop receiving callback notifications for a specific webhook.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The URL of the webhook to delete. Must match the exact webhook URL that was previously registered. |

#### 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 |

### UniOne Email Balance

**Slug:** `UNIONE_EMAIL_BALANCE`

Tool to retrieve current account balance. Use when you need to check your email usage and limits before sending large campaigns.

#### 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 |

### Cancel Scheduled Email

**Slug:** `UNIONE_EMAIL_CANCEL`

Tool to cancel a scheduled transactional email by its job ID. Use when you need to stop a pending email send before it's dispatched.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | ID of the scheduled email job to cancel. |

#### 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 |

### UniOne Email Domain Management

**Slug:** `UNIONE_EMAIL_DOMAIN`

Tool to manage sender domains in UniOne. Use when you need DNS records for verification, trigger verification or DKIM checks, list domains, or delete a domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return (only for 'list'). |
| `domain` | string | No | Domain name to operate on. Required for all operations except 'list'. |
| `offset` | integer | No | Index of first item (0-based) (only for 'list'). |
| `operation` | string ("get_dns_records" | "validate_verification_record" | "validate_dkim" | "list" | "delete") | Yes | Operation to perform on sender domains. |

#### 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 Event

**Slug:** `UNIONE_EMAIL_EVENT_GET`

Tool to retrieve details of a specific email event by its ID. Use when you need event information for auditing or diagnostics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | Unique identifier of the email event to retrieve. |

#### 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 Send Job

**Slug:** `UNIONE_EMAIL_GET`

Tool to retrieve detailed information about a specific email send job. Use when you need its delivery metrics and history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Unique identifier of the email send job |

#### 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 |

### UniOne Email List (Export)

**Slug:** `UNIONE_EMAIL_LIST`

Tool to export email events within a specified time frame. It creates an asynchronous event dump which can later be downloaded and parsed using UNIONE_EVENT_DUMP_GET.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Recipient email address |
| `limit` | integer | No | Max events per dump file (default 50). If >100000, multiple files are created. |
| `domain` | string | No | Recipient domain |
| `format` | string ("csv" | "csv_gzip") | No | Output format: 'csv' (default) or 'csv_gzip' |
| `status` | string ("accepted" | "sent" | "delivered" | "opened" | "clicked" | "unsubscribed" | "subscribed" | "soft_bounced" | "hard_bounced" | "spam") | No | Email status filter |
| `date_to` | string | No | ISO 8601 end timestamp |
| `aggregate` | string ("day_status" | "") | No | Aggregation over the period; cannot combine with filters when set |
| `date_from` | string | Yes | ISO 8601 start timestamp |
| `delimiter` | string ("," | ";") | No | CSV delimiter: ',' or ';' |
| `from_email` | string | No | Sender email address |
| `campaign_id` | string | No | Campaign identifier (decimal or UUID up to 128-bit) |
| `dump_fields` | array | No | Ordered list of columns for the report. Defaults to a useful set if omitted. |
| `delivery_status` | string | No | Comma-separated internal delivery statuses |

#### 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 |

### Resend Sent Email

**Slug:** `UNIONE_EMAIL_RESEND`

Tool to resend a previously sent email by its job ID. Use when you need to trigger a resend of an email that has already been sent and you have the original job ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Unique job ID of the originally sent email to resend. |

#### 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 |

### UniOne Email Resubscribe

**Slug:** `UNIONE_EMAIL_RESUBSCRIBE`

Tool to resubscribe a recipient who previously unsubscribed. Use when you need to restore a user's subscription status after they opt in again.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_email` | string | Yes | Email address of the user to be resubscribed |
| `from_name` | string | Yes | Name of the sender displayed to the recipient |
| `from_email` | string | Yes | Sender's email address to send the resubscribe message |

#### 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 |

### Resume Paused Email

**Slug:** `UNIONE_EMAIL_RESUME`

Tool to resume a paused transactional email by its job ID. Use when you need to restart a paused pending email send.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | ID of the paused email job to resume. |

#### 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 |

### UniOne Email SMTP Configuration

**Slug:** `UNIONE_EMAIL_SMTP`

Tool to retrieve SMTP server details and credentials. Use when you need to configure your mail client or library for SMTP sending.

#### 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 |

### UniOne Email Statistics

**Slug:** `UNIONE_EMAIL_STATISTICS`

Tool to retrieve email sending statistics over a specified time range. This action uses UniOne's event-dump aggregate API under the hood to compute daily statistics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date_to` | string | Yes | End date (inclusive) in YYYY-MM-DD format |
| `date_from` | string | Yes | Start date (inclusive) in YYYY-MM-DD format |

#### 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 |

### UniOne Email Unsubscribe

**Slug:** `UNIONE_EMAIL_UNSUBSCRIBE`

Tool to unsubscribe an email from future emails. Use when you need to stop all further transactional emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cause` | string | Yes | Suppression reason; must be 'unsubscribed' for this action |
| `email` | string | Yes | Email address to unsubscribe |
| `created` | string | No | UTC timestamp when the suppression was created (YYYY-MM-DD hh:mm:ss) |

#### 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 |

### Batch Email Validation

**Slug:** `UNIONE_EMAIL_VALIDATE_BATCH`

Tool to validate multiple email addresses in a batch. Use when you need to verify deliverability for a list of emails at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of email addresses to validate (must be valid email format). |

#### 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 Email from Suppression List

**Slug:** `UNIONE_EMAIL_VALIDATE_DELETE`

Tool to remove an email from the suppression list. Use when you need to re-enable sending emails to an address that was previously unsubscribed or suppressed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to remove from the suppression 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 |

### Retry Email Validation

**Slug:** `UNIONE_EMAIL_VALIDATE_RETRY`

Tool to retry an email validation request. Updated to re-run validation via the official single validation endpoint using the provided email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Email address to (re)validate (previously: request 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 |

### UniOne Email Webhook Types

**Slug:** `UNIONE_EMAIL_WEBHOOK_TYPES`

Tool to retrieve supported email webhook event types. Use when configuring your webhook callbacks.

#### 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 |

### Create Event Dump

**Slug:** `UNIONE_EVENT_DUMP_CREATE`

Tool to create an asynchronous CSV event dump. Use when you need to export transactional email events for a specified time window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Max events per file (default 50). If >100000, multiple files of 100000 events are created. |
| `filter` | object | No | Filters to apply when selecting events for the dump. |
| `format` | string ("csv" | "csv_gzip") | No | Output format: 'csv' (default) or 'csv_gzip'. |
| `end_time` | string | No | End of time window (non-inclusive) in UTC 'YYYY-MM-DD hh:mm:ss'. |
| `aggregate` | string ("day_status" | "") | No | Aggregation over the period: 'day_status' for daily stats. Cannot combine with filters when set. |
| `delimiter` | string ("," | ";") | No | Field delimiter for CSV: ',' or ';'. |
| `start_time` | string | Yes | Start of time window in UTC 'YYYY-MM-DD hh:mm:ss'. |
| `dump_fields` | array | No | Ordered list of columns for the report. Defaults to all standard fields if omitted. |
| `all_projects` | boolean | No | If true and projects are enabled, fetches data across all projects. |

#### 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 |

### UniOne Event Dump List

**Slug:** `UNIONE_EVENT_DUMP_LIST`

Tool to retrieve the full list of event dumps. Use when you need to view all existing event-dump tasks.

#### 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 Event Dump

**Slug:** `UNIONE_GET_EVENT_DUMP`

Tool to retrieve the status and download URLs of an event dump. Use when you need to check if a dump is ready and get its files.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dump_id` | string | Yes | Unique identifier of the event dump task (UUID format) |

#### 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 Suppression Details

**Slug:** `UNIONE_GET_SUPPRESSION`

Tool to check if an email is suppressed and retrieve the reason and date. Use when verifying why an email cannot receive messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check for suppression status |
| `all_projects` | boolean | No | Check across all projects. If not provided, checks only the current project. |

#### 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 Template

**Slug:** `UNIONE_GET_TEMPLATE`

Tool to get template properties by ID. Use when you need to retrieve the full template configuration and content for a specific template.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Template UUID |

#### 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 Webhook Configuration

**Slug:** `UNIONE_GET_WEBHOOK`

Tool to retrieve webhook configuration by its URL. Use when you need to check the current settings of an event notification handler.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Webhook URL to retrieve configuration for |

#### 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 |

### Schedule Email

**Slug:** `UNIONE_SCHEDULE_EMAIL`

Tool to schedule a transactional email up to 24 hours ahead. Use when you need to send an email at a specific future time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | object | Yes | Email message container with scheduling options |

#### 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 |

### Suppression List

**Slug:** `UNIONE_SUPPRESSION_LIST`

Tool to return the suppression list since a given date. Use when auditing bounced, unsubscribed, or blocked recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cause` | string ("unsubscribed" | "temporary_unavailable" | "permanent_unavailable" | "complained" | "blocked") | No | Optional cause filter. One of: unsubscribed, temporary_unavailable, permanent_unavailable, complained, blocked. New causes may be added. |
| `limit` | integer | No | Maximum number of records to return. Defaults to 50. |
| `cursor` | string | No | Pagination cursor. Omit for first call; use `cursor` from previous response for subsequent pages. |
| `source` | string ("user" | "system" | "subscriber") | No | Optional source filter. One of: user (set via suppression/set), system, subscriber. |
| `start_time` | string | No | UTC start time (YYYY-MM-DD hh:mm:ss) to fetch suppressions from. Ignored if `cursor` is provided. |

#### 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 |

### Delete Tag

**Slug:** `UNIONE_TAG_DELETE`

Tool to delete a specific tag. Use when you have confirmed the tag ID you wish to remove.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | integer | Yes | Unique identifier of the tag to delete. |

#### 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 |

### UniOne Tag List

**Slug:** `UNIONE_TAG_LIST`

Tool to retrieve all user-defined tags. Use when you need to fetch the full list of tags after authentication.

#### 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 |

### UniOne Template List

**Slug:** `UNIONE_TEMPLATE_LIST`

Tool to list email templates. Use when you need to retrieve available templates for transactional emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of templates to return, must be at least 1. |
| `offset` | integer | No | Starting index (0-based) 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 |

### Set Template

**Slug:** `UNIONE_TEMPLATE_SET`

Tool to set or update an email template. Use when you need to create or modify transactional email templates before sending messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template` | object | Yes | Template object to create or update. |

#### 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 |

### Set Webhook

**Slug:** `UNIONE_WEBHOOK_SET`

Tool to set or edit a webhook event notification handler. Use when you need to configure your webhook for event callbacks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Target URL to receive event notifications; ASCII only (use Punycode for non-ASCII) |
| `events` | object | No | Events container for webhook notifications |
| `status` | string ("active" | "disabled" | "stopped") | No | Webhook status: 'active' (default), 'disabled' (user-disabled), or 'stopped' (auto-stopped after 24h of failed calls) |
| `event_format` | string ("json_post" | "json_post_gzip") | No | Notification format: 'json_post' (default) or 'json_post_gzip' |
| `max_parallel` | integer | No | Maximum number of parallel requests allowed (5-100) |
| `single_event` | integer | No | 1 to send single event per call, 0 to batch multiple |
| `delivery_info` | integer | No | 1 to include detailed delivery info, 0 otherwise |

#### 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 |