---
canonical_url: "https://docs.composio.dev/toolkits/dynosend"
markdown_url: "https://docs.composio.dev/toolkits/dynosend.md"
product: "platform"
version: null
last_updated: null
---

# Dynosend

Dynosend is an email marketing platform for managing audiences and contacts, operating campaigns, sending transactional messages, and tracking customer events.

- **Category:** email
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `DYNOSEND`
- **Version:** 00000000_00

## Tools

### Add Email To Blacklist

**Slug:** `DYNOSEND_ADD_EMAIL_TO_BLACKLIST`

Permanently add an email address to the Dynosend blacklist. This cannot be undone through the Dynosend API because Dynosend exposes no removal operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to permanently blacklist. Dynosend provides no API operation to remove it from the blacklist. |

#### 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 Tags To Contact

**Slug:** `DYNOSEND_ADD_TAGS_TO_CONTACT`

Append one or more tags to a contact without replacing its existing tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | One or more non-empty tags to append to the contact. |
| `email` | string | No | Contact email; provide exactly one of email or contact_uid. |
| `contact_uid` | string | No | Contact UID; provide exactly one of contact_uid or email. |
| `audience_uid` | string | Yes | UID of the contact's audience. |

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

### Check Blacklist

**Slug:** `DYNOSEND_CHECK_BLACKLIST`

Check whether an email address is on the connected Dynosend account's blacklist and return its timestamp and reason when available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address whose Dynosend blacklist status to check. |

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

**Slug:** `DYNOSEND_CREATE_CONTACT`

Create a contact in an audience, optionally assigning tags and audience-defined custom fields. Can bypass double opt-in when explicitly requested.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Tags to assign to the new contact. |
| `email` | string | Yes | Email address for the new contact. |
| `audience_uid` | string | Yes | UID of the audience in which to create the contact. |
| `custom_fields` | object | No | Audience custom-field values keyed by field tag; use Get Audience to discover valid tags. |
| `ignore_double_opt_in` | boolean | No | Set true to bypass the audience's double opt-in flow and subscribe the contact immediately. |

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

**Slug:** `DYNOSEND_DELETE_CONTACT`

Permanently delete one contact from an audience for GDPR/CCPA erasure. This destructive operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email of the contact to permanently delete; provide exactly one of email or contact_uid. |
| `contact_uid` | string | No | Contact UID to permanently delete; provide exactly one of contact_uid or email. |
| `audience_uid` | string | Yes | UID of the contact's audience. The selected contact will be permanently deleted and cannot be recovered. |

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

### Find Duplicate Contacts

**Slug:** `DYNOSEND_FIND_DUPLICATE_CONTACTS`

Find contacts that use the same email address across all audiences in the connected Dynosend account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to search for across all Dynosend audiences. |

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

**Slug:** `DYNOSEND_GET_AUDIENCE`

Get one audience's configuration, custom-field definitions, contact information, and subscription statistics by audience UID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `audience_uid` | string | Yes | Audience UID returned by List Audiences. |

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

**Slug:** `DYNOSEND_GET_CAMPAIGN`

Get one campaign's configuration and delivery, open, click, spam, bounce, and unsubscribe insights.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_uid` | string | Yes | Campaign UID returned by List 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 |

### Get Contact

**Slug:** `DYNOSEND_GET_CONTACT`

Get one contact in an audience by contact UID or email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact email; provide exactly one of email or contact_uid. |
| `contact_uid` | string | No | Contact UID; provide exactly one of contact_uid or email. |
| `audience_uid` | string | Yes | UID of the contact's audience. |

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

### List Audiences

**Slug:** `DYNOSEND_LIST_AUDIENCES`

List audiences available to the connected Dynosend account, including the UID needed by audience and contact tools.

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

### List Campaigns

**Slug:** `DYNOSEND_LIST_CAMPAIGNS`

List campaigns in the connected Dynosend account, including status and the campaign UID used by campaign tools.

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

### List Contacts

**Slug:** `DYNOSEND_LIST_CONTACTS`

Return one page of contacts in a Dynosend audience, including contact UIDs, subscription status, tags, and audience-defined custom-field values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch. Start at 1 and increment while Dynosend returns contacts; an empty page indicates the end. |
| `per_page` | integer | No | Number of contacts requested for this page. Dynosend defaults to 20 and does not document a maximum. |
| `audience_uid` | string | Yes | UID of the audience whose contacts to 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 |

### Record Contact Event

**Slug:** `DYNOSEND_RECORD_CONTACT_EVENT`

Record an application event for a contact in an audience. Dynosend stores the event persistently for automations and segmentation, and its API does not provide an operation to delete recorded events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact email; provide exactly one of email or contact_uid. |
| `event_name` | string | Yes | Non-empty event name configured in Dynosend, such as starts_trial. Dynosend's documented naming rules conflict with its examples, so this tool does not impose a character pattern. |
| `contact_uid` | string | No | Contact UID; provide exactly one of contact_uid or email. |
| `audience_uid` | string | Yes | UID of the contact's audience. |

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

### Send Transactional Message

**Slug:** `DYNOSEND_SEND_TRANSACTIONAL_MESSAGE`

Send a configured Dynosend transactional message. This immediately sends email and may create the recipient as a new Dynosend contact if the address is unknown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subject` | string | No | Optional subject override. |
| `html_body` | string | No | HTML content; required together with text_body in external content mode. |
| `recipient` | string | Yes | Recipient email address. Calling this tool sends email immediately, and Dynosend may create an unknown recipient as a new contact. |
| `text_body` | string | No | Plain-text content; required together with html_body in external content mode. |
| `custom_tags` | array | No | Personalization values for an internally configured message. |
| `content_mode` | string ("internal" | "external") | Yes | Content mode configured for the transactional message. This is used only to validate the matching payload and is never sent to Dynosend. |
| `custom_headers` | array | No | Additional message headers as name/value pairs. |
| `transactional_uid` | string | Yes | UID of the preconfigured Dynosend transactional 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 |

### Set Campaign Delivery State

**Slug:** `DYNOSEND_SET_CAMPAIGN_DELIVERY_STATE`

Pause a sending campaign or resume a paused campaign by setting its delivery state to paused or sending. Resuming can send queued emails to campaign recipients; this does not start a ready campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("paused" | "sending") | Yes | Delivery state to apply: paused stops delivery; sending resumes delivery and can send queued emails to campaign recipients. |
| `campaign_uid` | string | Yes | UID of the sending or paused campaign whose delivery state to change. |

#### 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 Contact Subscription Status

**Slug:** `DYNOSEND_SET_CONTACT_SUBSCRIPTION_STATUS`

Set a contact's subscription status to subscribed or unsubscribed in an audience.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact email; provide exactly one of email or contact_uid. |
| `status` | string ("subscribed" | "unsubscribed") | Yes | Subscription state to apply. |
| `contact_uid` | string | No | Contact UID; provide exactly one of contact_uid or email. |
| `audience_uid` | string | Yes | UID of the contact's audience. |

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

### Start Campaign

**Slug:** `DYNOSEND_START_CAMPAIGN`

Start a ready broadcast campaign. This immediately sends email to all campaign recipients and cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_uid` | string | Yes | UID of the ready campaign to start. Starting immediately sends email to all campaign recipients and cannot be undone. |

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

**Slug:** `DYNOSEND_UPDATE_CONTACT`

Update a contact's email, replace its complete tag set, or set audience-defined custom fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Non-empty complete replacement tag set. This field may be omitted only when another update field is provided. Use Add Tags To Contact to append without removing existing tags. |
| `new_email` | string | No | Replacement email address. This field may be omitted only when another update field is provided. |
| `contact_uid` | string | No | Contact UID; provide exactly one of contact_uid or current_email. |
| `audience_uid` | string | Yes | UID of the contact's audience. |
| `current_email` | string | No | Current contact email used as the selector; provide exactly one of current_email or contact_uid. |
| `custom_fields` | object | No | Custom-field values keyed by audience field tag. This field may be omitted only when another update field 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 |