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

# BlueFox Email

> BlueFox Email provides APIs for managing contacts and subscriber lists and sending transactional and triggered emails.

![BlueFox Email logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/bluefox_email.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=938006c39089e7cddc2fb30db0d19e4e)

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

## Tools

> [accordion] Create Contact
>
> **Slug:** `BLUEFOX_EMAIL_CREATE_CONTACT`
>
> Create a contact in the specified BlueFox project. This creates persistent project data but does not subscribe the contact to a list.
>
> #### Input Parameters
>
> **data** `object`
>
> Custom-property values keyed by the API names configured in the BlueFox project.
>
> **name** `string`
>
> Contact name.
>
> **email** `string` *required*
>
> Email address for the new contact.
>
> **project\_id** `string` *required*
>
> BlueFox project ID from the project's settings or a contact Code Guide.
>
> #### 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:** `BLUEFOX_EMAIL_DELETE_CONTACT`
>
> Permanently delete a contact by its current email address from the specified BlueFox project. This is destructive and may affect related email workflows.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> BlueFox project ID from the project's settings or a contact Code Guide.
>
> **contact\_email** `string` *required*
>
> Current email address of the contact to permanently delete.
>
> #### 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:** `BLUEFOX_EMAIL_GET_CONTACT`
>
> Retrieve one contact by its current email address from the specified BlueFox project.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> BlueFox project ID from the project's settings or a contact Code Guide.
>
> **contact\_email** `string` *required*
>
> Current email address identifying the contact.
>
> #### 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 Subscriber
>
> **Slug:** `BLUEFOX_EMAIL_GET_SUBSCRIBER`
>
> Retrieve one subscriber by current email address from a known BlueFox subscriber list.
>
> #### Input Parameters
>
> **subscriber\_email** `string` *required*
>
> Current email address identifying the subscriber in the list.
>
> **subscriber\_list\_id** `string` *required*
>
> Subscriber-list ID copied from the BlueFox UI. BlueFox does not provide an API endpoint for discovering list IDs.
>
> #### 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:** `BLUEFOX_EMAIL_LIST_CONTACTS`
>
> List contacts in the specified BlueFox project. The tool does not expose filtering or pagination controls.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> BlueFox project ID from the project's settings or a contact Code Guide.
>
> #### 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 Subscribers
>
> **Slug:** `BLUEFOX_EMAIL_LIST_SUBSCRIBERS`
>
> List subscribers in one known BlueFox subscriber list. The tool does not expose filtering or pagination controls.
>
> #### Input Parameters
>
> **subscriber\_list\_id** `string` *required*
>
> Subscriber-list ID copied from the BlueFox UI. BlueFox does not provide an API for discovering list IDs.
>
> #### 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 Email
>
> **Slug:** `BLUEFOX_EMAIL_SEND_TRANSACTIONAL_EMAIL`
>
> Queue one transactional email for an external recipient. This externally visible action is irreversible and consumes BlueFox send credits; insufficient credits can prevent the send.
>
> #### Input Parameters
>
> **data** `object`
>
> Handlebars merge-tag values expected by the selected template.
>
> **email** `string` *required*
>
> External recipient email address. Calling this tool immediately sends an irreversible email and consumes BlueFox send credits.
>
> **attachments** `array`
>
> Files to attach. BlueFox publishes no attachment count or size limit; each item must have a filename with an extension and base64 content.
>
> **transactional\_id** `string` *required*
>
> Transactional template ID copied from the BlueFox Code Guide. BlueFox does not provide an API endpoint for discovering template IDs.
>
> #### 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 Triggered Email
>
> **Slug:** `BLUEFOX_EMAIL_SEND_TRIGGERED_EMAIL`
>
> Send a triggered email to one or more specified recipients; only active subscribers on the associated list receive it. This externally visible action is irreversible and consumes BlueFox send credits; insufficient credits can prevent sending.
>
> #### Input Parameters
>
> **data** `object`
>
> Handlebars merge-tag values expected by the selected triggered flow.
>
> **emails** `array` *required*
>
> Non-empty list of external recipient email addresses. Starting this irreversible flow may send multiple messages over time to every recipient and consumes BlueFox send credits. BlueFox publishes no recipient maximum.
>
> **attachments** `array`
>
> Files to attach. Each item accepts canonical file\_name or provider-style fileName plus base64 content. BlueFox publishes no attachment count or size limit.
>
> **triggered\_id** `string` *required*
>
> Triggered email flow ID copied from BlueFox. BlueFox does not provide an API endpoint for discovering flow IDs.
>
> #### 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] Subscribe To List
>
> **Slug:** `BLUEFOX_EMAIL_SUBSCRIBE_TO_LIST`
>
> Create a subscriber-list membership. This changes persistent subscription state and may send a double-opt-in email; setting status to active bypasses double opt-in.
>
> #### Input Parameters
>
> **data** `object`
>
> Custom-property values keyed by the API names configured in the BlueFox project.
>
> **name** `string`
>
> Subscriber name, if known.
>
> **email** `string` *required*
>
> Email address to subscribe to the list.
>
> **status** `string`
>
> Set to 'active' only when intentionally bypassing double opt-in. Omit this field to use the list's normal opt-in behavior, which may send a confirmation email.
>
> **subscriber\_list\_id** `string` *required*
>
> Subscriber-list ID copied from Manage List > Code Guide. BlueFox does not provide an API endpoint for discovering list IDs.
>
> #### 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:** `BLUEFOX_EMAIL_UPDATE_CONTACT`
>
> Update a contact identified by its current email address in the specified BlueFox project. Provide at least one of new\_email, name, or data. This changes persistent contact data.
>
> #### Input Parameters
>
> **data** `object`
>
> Replacement custom-property values keyed by the API names configured in the BlueFox project. At least one mutable field is required.
>
> **name** `string`
>
> Replacement contact name. At least one mutable field is required.
>
> **new\_email** `string`
>
> Replacement email address. Later lookups must use this new address. At least one mutable field is required.
>
> **project\_id** `string` *required*
>
> BlueFox project ID from the project's settings or a contact Code Guide.
>
> **contact\_email** `string` *required*
>
> Current email address identifying the contact.
>
> #### 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 Subscriber
>
> **Slug:** `BLUEFOX_EMAIL_UPDATE_SUBSCRIBER`
>
> Update a subscriber's identity, custom data, or state in a known BlueFox list. Provide at least one of new\_email, name, data, status, or paused\_until. This can unsubscribe, pause, or reactivate the subscriber and changes future email eligibility.
>
> #### Input Parameters
>
> **data** `object`
>
> Replacement custom-property values keyed by the API names configured in the BlueFox project. At least one mutable field is required.
>
> **name** `string`
>
> Replacement subscriber name. At least one mutable field is required.
>
> **status** `string ("active" | "unsubscribed" | "paused")`
>
> New subscription state: 'active' re-enables email, 'unsubscribed' opts out, and 'paused' suppresses email until paused\_until. At least one mutable field is required.
>
> **new\_email** `string`
>
> Replacement email address. Later lookups must use this new address. At least one mutable field is required.
>
> **paused\_until** `string`
>
> Future timezone-aware ISO 8601 date and time until which delivery is paused. Required when status is 'paused' and otherwise not allowed. At least one mutable field is required.
>
> **subscriber\_email** `string` *required*
>
> Current email address identifying the subscriber.
>
> **subscriber\_list\_id** `string` *required*
>
> Subscriber-list ID copied from the BlueFox UI. BlueFox does not provide an API endpoint for discovering list IDs.
>
> #### 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
