> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynosend

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

![Dynosend logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/dynosend.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=3ba6906f537deec951e2315a64ae7275)

* **Category:** email
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 18
* **Triggers:** 0
* **Slug:** `DYNOSEND`
* **Version:** 20261030\_00

## Tools

> [accordion] 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
>
> **email** `string` *required*
>
> Email address to permanently blacklist. Dynosend provides no API operation to remove it from the blacklist.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **tags** `array` *required*
>
> One or more non-empty tags to append to the contact.
>
> **email** `string`
>
> Contact email; provide exactly one of email or contact\_uid.
>
> **contact\_uid** `string`
>
> Contact UID; provide exactly one of contact\_uid or email.
>
> **audience\_uid** `string` *required*
>
> UID of the contact's audience.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string` *required*
>
> Email address whose Dynosend blacklist status to check.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **tags** `array`
>
> Tags to assign to the new contact.
>
> **email** `string` *required*
>
> Email address for the new contact.
>
> **audience\_uid** `string` *required*
>
> UID of the audience in which to create the contact.
>
> **custom\_fields** `object`
>
> Audience custom-field values keyed by field tag; use Get Audience to discover valid tags.
>
> **ignore\_double\_opt\_in** `boolean`
>
> Set true to bypass the audience's double opt-in flow and subscribe the contact immediately.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string`
>
> Email of the contact to permanently delete; provide exactly one of email or contact\_uid.
>
> **contact\_uid** `string`
>
> Contact UID to permanently delete; provide exactly one of contact\_uid or email.
>
> **audience\_uid** `string` *required*
>
> UID of the contact's audience. The selected contact will be permanently deleted and cannot be recovered.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string` *required*
>
> Email address to search for across all Dynosend audiences.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Audience
>
> **Slug:** `DYNOSEND_GET_AUDIENCE`
>
> Get one audience's configuration, custom-field definitions, contact information, and subscription statistics by audience UID.
>
> #### Input Parameters
>
> **audience\_uid** `string` *required*
>
> Audience UID returned by List Audiences.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign
>
> **Slug:** `DYNOSEND_GET_CAMPAIGN`
>
> Get one campaign's configuration and delivery, open, click, spam, bounce, and unsubscribe insights.
>
> #### Input Parameters
>
> **campaign\_uid** `string` *required*
>
> Campaign UID returned by List Campaigns.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `DYNOSEND_GET_CONTACT`
>
> Get one contact in an audience by contact UID or email address.
>
> #### Input Parameters
>
> **email** `string`
>
> Contact email; provide exactly one of email or contact\_uid.
>
> **contact\_uid** `string`
>
> Contact UID; provide exactly one of contact\_uid or email.
>
> **audience\_uid** `string` *required*
>
> UID of the contact's audience.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Audiences
>
> **Slug:** `DYNOSEND_LIST_AUDIENCES`
>
> List audiences available to the connected Dynosend account, including the UID needed by audience and contact tools.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Campaigns
>
> **Slug:** `DYNOSEND_LIST_CAMPAIGNS`
>
> List campaigns in the connected Dynosend account, including status and the campaign UID used by campaign tools.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Page number to fetch. Start at 1 and increment while Dynosend returns contacts; an empty page indicates the end.
>
> **per\_page** `integer`
>
> Number of contacts requested for this page. Dynosend defaults to 20 and does not document a maximum.
>
> **audience\_uid** `string` *required*
>
> UID of the audience whose contacts to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string`
>
> Contact email; provide exactly one of email or contact\_uid.
>
> **event\_name** `string` *required*
>
> 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`
>
> Contact UID; provide exactly one of contact\_uid or email.
>
> **audience\_uid** `string` *required*
>
> UID of the contact's audience.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **subject** `string`
>
> Optional subject override.
>
> **html\_body** `string`
>
> HTML content; required together with text\_body in external content mode.
>
> **recipient** `string` *required*
>
> Recipient email address. Calling this tool sends email immediately, and Dynosend may create an unknown recipient as a new contact.
>
> **text\_body** `string`
>
> Plain-text content; required together with html\_body in external content mode.
>
> **custom\_tags** `array`
>
> Personalization values for an internally configured message.
>
> **content\_mode** `string ("internal" | "external")` *required*
>
> 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`
>
> Additional message headers as name/value pairs.
>
> **transactional\_uid** `string` *required*
>
> UID of the preconfigured Dynosend transactional message.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **state** `string ("paused" | "sending")` *required*
>
> Delivery state to apply: paused stops delivery; sending resumes delivery and can send queued emails to campaign recipients.
>
> **campaign\_uid** `string` *required*
>
> UID of the sending or paused campaign whose delivery state to change.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string`
>
> Contact email; provide exactly one of email or contact\_uid.
>
> **status** `string ("subscribed" | "unsubscribed")` *required*
>
> Subscription state to apply.
>
> **contact\_uid** `string`
>
> Contact UID; provide exactly one of contact\_uid or email.
>
> **audience\_uid** `string` *required*
>
> UID of the contact's audience.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **campaign\_uid** `string` *required*
>
> UID of the ready campaign to start. Starting immediately sends email to all campaign recipients and cannot be undone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `DYNOSEND_UPDATE_CONTACT`
>
> Update a contact's email, replace its complete tag set, or set audience-defined custom fields.
>
> #### Input Parameters
>
> **tags** `array`
>
> 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`
>
> Replacement email address. This field may be omitted only when another update field is provided.
>
> **contact\_uid** `string`
>
> Contact UID; provide exactly one of contact\_uid or current\_email.
>
> **audience\_uid** `string` *required*
>
> UID of the contact's audience.
>
> **current\_email** `string`
>
> Current contact email used as the selector; provide exactly one of current\_email or contact\_uid.
>
> **custom\_fields** `object`
>
> Custom-field values keyed by audience field tag. This field may be omitted only when another update field is provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
