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

# Maildroppa

> Maildroppa is an email marketing platform for managing subscribers, segmentation, newsletters, transactional email, events, and webhooks.

![Maildroppa logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/maildroppa.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=dc8a99eb3e3adb83a017391c8661cac2)

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

## Tools

> [accordion] Archive Tag
>
> **Slug:** `MAILDROPPA_ARCHIVE_TAG`
>
> Archive one customer-managed tag. Archiving prevents new assignments but preserves existing subscriber assignments and can be reversed by restoring the tag. Use the tag-usage tool first to inspect archive blockers.
>
> #### Input Parameters
>
> **tag\_id** `string` *required*
>
> Unique identifier of the customer-managed tag to archive.
>
> #### 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] Count Segment Subscribers
>
> **Slug:** `MAILDROPPA_COUNT_SEGMENT_SUBSCRIBERS`
>
> Return the current number of subscribers matching one stored segment.
>
> #### Input Parameters
>
> **segment\_id** `string` *required*
>
> Unique identifier of the segment whose matching subscribers to count.
>
> #### 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 Segment
>
> **Slug:** `MAILDROPPA_CREATE_SEGMENT`
>
> Create a subscriber segment from field, tag, or nested-segment conditions.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Segment name shown in Maildroppa.
>
> **condition\_groups** `array` *required*
>
> Non-empty filter groups. Conditions in one group are ANDed and groups are ORed.
>
> #### 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 Subscriber
>
> **Slug:** `MAILDROPPA_CREATE_SUBSCRIBER`
>
> Create a subscriber without sending an opt-in message, with optional typed field values and tag assignments.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Subscriber email address.
>
> **fields** `array`
>
> Custom field values with a field ID and matching typed value payload.
>
> **tag\_ids** `array`
>
> Existing tag IDs to assign to the subscriber.
>
> **first\_name** `string`
>
> Subscriber first name.
>
> **subscriber\_status** `string ("PENDING" | "CONFIRMED" | "UNSUBSCRIBED" | "COLD" | "BOUNCED" | "SOFT_BOUNCED" | "BLOCKED" | "DELETED")`
>
> Initial subscriber status. Use PENDING only when intended; this action does not send a confirmation email.
>
> #### 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 Subscribers
>
> **Slug:** `MAILDROPPA_CREATE_SUBSCRIBERS`
>
> Sequentially create 1–25 subscribers without sending opt-in messages. The batch is non-atomic and stops after a systemic or ambiguous failure; a completed batch response reports an outcome for each item.
>
> #### Input Parameters
>
> **subscribers** `array` *required*
>
> Subscribers to create sequentially in request order (1-25). The batch is non-atomic: successful creations remain if a later item fails.
>
> #### 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 Tag
>
> **Slug:** `MAILDROPPA_CREATE_TAG`
>
> Create a customer-managed tag that can be assigned to subscribers.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Tag name shown in Maildroppa.
>
> #### 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 Segment
>
> **Slug:** `MAILDROPPA_DELETE_SEGMENT`
>
> Permanently delete exactly one stored subscriber segment identified by an explicit segment ID. This action cannot select segments by filter or bulk criteria.
>
> #### Input Parameters
>
> **segment\_id** `string` *required*
>
> Exact ID of the single stored segment to permanently delete. Obtain and verify this ID before calling; filters and bulk selection are not accepted.
>
> #### 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 Subscriber
>
> **Slug:** `MAILDROPPA_DELETE_SUBSCRIBER`
>
> Permanently delete exactly one subscriber identified by an explicit subscriber ID. This action cannot select subscribers by email, filter, or bulk criteria.
>
> #### Input Parameters
>
> **subscriber\_id** `string` *required*
>
> Exact ID of the single subscriber to permanently delete. Obtain and verify this ID before calling; email addresses and bulk selection are not accepted.
>
> #### 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 Form Embedding
>
> **Slug:** `MAILDROPPA_GET_FORM_EMBEDDING`
>
> Return an active Maildroppa form's ordered input-field definition for rendering in a trusted website integration.
>
> #### Input Parameters
>
> **form\_id** `string` *required*
>
> Unique identifier of the active form, obtainable from List Forms.
>
> #### 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 Segment
>
> **Slug:** `MAILDROPPA_GET_SEGMENT`
>
> Return one stored subscriber segment and its complete filter expression by ID.
>
> #### Input Parameters
>
> **segment\_id** `string` *required*
>
> Unique identifier of the segment.
>
> #### 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:** `MAILDROPPA_GET_SUBSCRIBER`
>
> Return one Maildroppa subscriber by ID, including display field values, tag IDs, status, registration date, and GDPR agreement.
>
> #### Input Parameters
>
> **subscriber\_id** `string` *required*
>
> Unique identifier of the subscriber.
>
> #### 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 Tag Usage
>
> **Slug:** `MAILDROPPA_GET_TAG_USAGE`
>
> Return the subscriber assignment count and archive or permanent-delete blockers for one Maildroppa tag.
>
> #### Input Parameters
>
> **tag\_id** `string` *required*
>
> Unique identifier of the tag whose current usage to inspect.
>
> #### 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 Forms
>
> **Slug:** `MAILDROPPA_LIST_FORMS`
>
> Return signup form overviews with IDs, type, status, publication state, and public routing details.
>
> #### 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 RSS Newsletters
>
> **Slug:** `MAILDROPPA_LIST_RSS_NEWSLETTERS`
>
> Return the account's RSS newsletter configurations without activating, checking, or sending them.
>
> #### 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 RSS Sender Profiles
>
> **Slug:** `MAILDROPPA_LIST_RSS_SENDER_PROFILES`
>
> Return sender profiles available to RSS newsletters, including verification and delivery readiness.
>
> #### 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 Segments
>
> **Slug:** `MAILDROPPA_LIST_SEGMENTS`
>
> Return the account's stored subscriber segments and filter expressions.
>
> #### 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 Subscriber Activity
>
> **Slug:** `MAILDROPPA_LIST_SUBSCRIBER_ACTIVITY`
>
> Return one page of a subscriber's activity timeline with delivery eligibility and summary counts.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum activity entries to return in this page.
>
> **cursor** `string`
>
> Continuation cursor returned by a previous activity call. Omit for the first page.
>
> **subscriber\_id** `string` *required*
>
> Unique identifier of the subscriber whose activity to return.
>
> #### 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 Subscriber Fields
>
> **Slug:** `MAILDROPPA_LIST_SUBSCRIBER_FIELDS`
>
> Return built-in and custom subscriber field definitions, optionally including archived custom fields.
>
> #### Input Parameters
>
> **include\_archived** `boolean`
>
> Whether to include archived custom fields along with active and built-in fields.
>
> #### 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:** `MAILDROPPA_LIST_SUBSCRIBERS`
>
> Return one page of subscribers, optionally filtered by free text, status, or structured segment conditions. Pass next\_cursor back as cursor to continue.
>
> #### Input Parameters
>
> **query** `string`
>
> Free-text subscriber search. Cannot be combined with condition\_groups.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call. The cursor retains the original route and filters.
>
> **status** `string ("PENDING" | "CONFIRMED" | "UNSUBSCRIBED" | "COLD" | "BOUNCED" | "SOFT_BOUNCED" | "BLOCKED" | "DELETED")`
>
> Return only subscribers with this status.
>
> **page\_size** `integer`
>
> Maximum subscribers to return in this page.
>
> **condition\_groups** `array`
>
> Structured filters. Conditions in one group are ANDed and groups are ORed. Cannot be combined with query.
>
> #### 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 Tags
>
> **Slug:** `MAILDROPPA_LIST_TAGS`
>
> Return account tags, optionally including archived tags.
>
> #### Input Parameters
>
> **include\_archived** `boolean`
>
> Whether to include archived tags in addition to active tags.
>
> #### 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] Restore Tag
>
> **Slug:** `MAILDROPPA_RESTORE_TAG`
>
> Restore an archived customer-managed Maildroppa tag so it can be assigned to subscribers again.
>
> #### Input Parameters
>
> **tag\_id** `string` *required*
>
> Unique identifier of the archived customer-managed tag to restore.
>
> #### 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 Segment
>
> **Slug:** `MAILDROPPA_UPDATE_SEGMENT`
>
> Replace a segment's name and complete filter expression. This is a full replacement, so supply every condition group that should remain.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Replacement segment name.
>
> **segment\_id** `string` *required*
>
> Unique identifier of the segment to update.
>
> **condition\_groups** `array` *required*
>
> Complete replacement filter groups. Conditions in one group are ANDed and groups are ORed; omitted existing groups are removed.
>
> #### 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 Tag
>
> **Slug:** `MAILDROPPA_UPDATE_TAG`
>
> Rename an existing customer-managed tag.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New tag name shown in Maildroppa.
>
> **tag\_id** `string` *required*
>
> Unique identifier of the customer-managed tag to rename.
>
> #### 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
