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

# Dotsimple

> DotSimple is a comprehensive social media management tool that enables users to plan, create, and publish content across multiple platforms, leveraging AI for content generation and providing analytics for performance optimization.

![Dotsimple logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/dotsimple.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=0451f8d74878acc577f5fb1239c041f4)

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

## Tools

> [accordion] Create Tag
>
> **Slug:** `DOTSIMPLE_CREATE_TAG`
>
> Create a new tag in DotSimple workspace for categorizing and organizing social media content. Tags are used to label and filter posts, drafts, and media files in DotSimple. Each tag has a unique name and color for easy visual identification in the dashboard. Use this tool when you need to: - Create a new category for content organization - Set up tags before scheduling posts - Organize content by topics, campaigns, or priorities Example: Create a tag named "news" with sky blue color "#38bdf8" for news-related posts. Note: Requires workspace\_id in authentication configuration. Get your workspace\_id from the DotSimple dashboard URL: [https://app.dotsimple.io/app/YOUR-WORKSPACE-ID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-ID/)
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the tag to be created. Used to categorize and filter content in DotSimple.
>
> **hex\_color** `string` *required*
>
> Hexadecimal color code for the tag in format '#RRGGBB'. Must include the '#' prefix followed by exactly 6 hexadecimal digits. Example: '#38bdf8' for sky blue.
>
> **workspace\_id** `string`
>
> DotSimple workspace UUID. If not provided, will attempt to use workspace\_id from auth configuration or base\_url. Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
>
> #### 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 Media Files
>
> **Slug:** `DOTSIMPLE_DELETE_MEDIA_FILES`
>
> Deletes one or more media files (images/videos) from your DotSimple workspace. Use this tool when you need to remove media files that are no longer needed. You must provide the media file IDs as strings. Use the list\_media\_files tool first to get the IDs of files you want to delete. Returns a success indicator when deletion completes.
>
> #### Input Parameters
>
> **items** `array` *required*
>
> Array of media file IDs (as strings) to delete from the workspace
>
> #### 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 Tag
>
> **Slug:** `DOTSIMPLE_DELETE_TAG`
>
> Delete a tag by its UUID from your DotSimple workspace. Use this tool when you need to remove a specific tag. Ensure the UUID is correct before invoking. The tag will be permanently deleted from your workspace. Note: Requires workspace\_id in authentication configuration. Get your workspace\_id from the DotSimple dashboard URL: [https://app.dotsimple.io/app/YOUR-WORKSPACE-ID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-ID/)
>
> #### Input Parameters
>
> **uuid** `string` *required*
>
> UUID of the tag to delete
>
> **workspace\_id** `string`
>
> DotSimple workspace UUID. If not provided, will attempt to use workspace\_id from auth configuration or base\_url. Find it in your DotSimple dashboard URL: [https://app.dotsimple.io/app/YOUR-WORKSPACE-ID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-ID/)
>
> #### 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 Media File
>
> **Slug:** `DOTSIMPLE_GET_MEDIA_FILE`
>
> Retrieve selected metadata for a specific DotSimple media file by ID. Returned URLs have their query strings removed.
>
> #### Input Parameters
>
> **mediaFileId** `string` *required*
>
> The unique identifier of the media file
>
> **workspace\_id** `string`
>
> DotSimple workspace UUID. If not provided, will attempt to use workspace\_id from auth configuration or base\_url. Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
>
> #### 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 by UUID
>
> **Slug:** `DOTSIMPLE_GET_TAG`
>
> Tool to retrieve details for a specific tag by UUID. Use when you need full tag information after obtaining its identifier.
>
> #### Input Parameters
>
> **tag\_id** `string` *required*
>
> The UUID of the tag to retrieve
>
> **workspace\_id** `string`
>
> The UUID of the DotSimple workspace. Can be found in the DotSimple dashboard URL (e.g., [https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/)...). If not provided, will attempt to use workspace\_id from auth configuration.
>
> #### 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 Accounts
>
> **Slug:** `DOTSIMPLE_LIST_ACCOUNTS`
>
> List all connected social media accounts in the DotSimple workspace. Returns details about each connected account including ID, name, type (e.g., Google, Microsoft), connection status, and credentials. Use this to discover available accounts before posting or scheduling content to social platforms. Note: Requires workspace\_id to be configured in auth settings or provided as a parameter.
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> DotSimple workspace UUID. If not provided, will attempt to use workspace\_id from auth configuration or base\_url. Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
>
> #### 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 Autoresponders
>
> **Slug:** `DOTSIMPLE_LIST_AUTORESPONDERS`
>
> List all autoresponders in the DotSimple workspace with optional pagination. Returns details about each autoresponder including ID, name, and status. Use this to browse through your autoresponder setup and check their current state. Note: Requires workspace\_id to be configured in auth settings or provided as a parameter.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed).
>
> **per\_page** `integer`
>
> Number of items to return per page.
>
> **workspace\_id** `string`
>
> DotSimple workspace UUID. If not provided, will attempt to use workspace\_id from auth configuration or base\_url. Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
>
> #### 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 Media Files
>
> **Slug:** `DOTSIMPLE_LIST_MEDIA_FILES`
>
> List media files in a specified DotSimple workspace to browse the media library and file metadata, such as names, types, URLs, and thumbnails. Provide the workspace UUID and optionally select a page of results.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination
>
> **workspace\_id** `string` *required*
>
> The UUID of the DotSimple workspace. Can be found in the DotSimple dashboard URL (e.g., [https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/)...)
>
> #### 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 Posts
>
> **Slug:** `DOTSIMPLE_LIST_POSTS`
>
> List posts in a specified DotSimple workspace, including their status and content. Provide the workspace UUID and optionally select a page and page size to browse the results.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (1-indexed)
>
> **page\_size** `integer`
>
> Number of posts per page
>
> **workspace\_id** `string` *required*
>
> The UUID of the DotSimple workspace. Can be found in the DotSimple dashboard URL (e.g., [https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/)...)
>
> #### 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 Reports
>
> **Slug:** `DOTSIMPLE_LIST_REPORTS`
>
> List all account-level email marketing reports from the DotSimple workspace. Returns paginated report entries with aggregated metrics for each date, including emails sent, delivered, opens, clicks, unsubscribes, bounces, and complaints. Use this to fetch account-level performance metrics chronologically after authentication. Note: Requires workspace\_id to be configured in auth settings or provided as a parameter.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (1-indexed)
>
> **page\_size** `integer`
>
> Number of report entries per page
>
> **workspace\_id** `string`
>
> DotSimple workspace UUID. If not provided, will attempt to use workspace\_id from auth configuration or base\_url. Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
>
> #### 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:** `DOTSIMPLE_LIST_TAGS`
>
> List all tags available in a DotSimple workspace for content organization and categorization. Tags in DotSimple are used to label and categorize social media posts, drafts, and media files. Each tag has a unique name and hex color for visual identification. Use this tool when you need to: - View all available tags in the workspace - Get tag IDs for assigning to posts - Retrieve tag colors and metadata - Check existing tags before creating new ones **Required:** workspace\_id (UUID format) - obtain from DotSimple dashboard URL or connection config
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> The UUID of the DotSimple workspace. If not provided, will attempt to extract from auth configuration or base\_url. Find your workspace\_id in the DotSimple dashboard URL: [https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/](https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/)
>
> #### 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
