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

- **Category:** social media marketing
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `DOTSIMPLE`
- **Version:** 20260227_00

## Tools

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the tag to be created. Used to categorize and filter content in DotSimple. |
| `hex_color` | string | Yes | 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 | No | 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

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items` | array | Yes | Array of media file IDs (as strings) to delete from the workspace |

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the tag to delete |
| `workspace_id` | string | No | 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/ |

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

**Slug:** `DOTSIMPLE_GET_MEDIA_FILE`

Tool to retrieve details of a specific media file. Use when you have the mediaFileId and need its metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mediaFileId` | string | Yes | The unique identifier of the media file |
| `workspace_id` | string | No | 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

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tagId` | string | Yes | The UUID of the tag to retrieve |
| `workspace_id` | string | No | The UUID of the DotSimple workspace. Can be found in the DotSimple dashboard URL (e.g., https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/...). If not provided, will attempt to use workspace_id from auth configuration. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | string | No | 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

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). |
| `per_page` | integer | No | Number of items to return per page. |
| `workspace_id` | string | No | 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

| 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 Media Files

**Slug:** `DOTSIMPLE_LIST_MEDIA_FILES`

List all media files in a DotSimple workspace with optional pagination. This tool retrieves media files from a specific workspace. The workspace_id is required and can be found in the DotSimple dashboard URL. Use when you need to: - Browse all uploaded media files - Retrieve media file metadata (name, type, URL, thumbnail) - Paginate through media library

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `workspace_id` | string | Yes | The UUID of the DotSimple workspace. Can be found in the DotSimple dashboard URL (e.g., https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/...) |

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

**Slug:** `DOTSIMPLE_LIST_POSTS`

List all posts in a DotSimple workspace with optional pagination. This tool retrieves posts from a specific workspace. The workspace_id is required and can be found in your DotSimple dashboard URL (e.g., https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/...). Use this when you need to: - View all posts in a workspace - Paginate through large sets of posts - Check post status (published/draft) - Access post metadata (author, timestamps, content) Pagination is supported via optional page and page_size parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-indexed) |
| `page_size` | integer | No | Number of posts per page |
| `workspace_id` | string | Yes | The UUID of the DotSimple workspace. Can be found in the DotSimple dashboard URL (e.g., https://app.dotsimple.io/app/YOUR-WORKSPACE-UUID/...) |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-indexed) |
| `page_size` | integer | No | Number of report entries per page |
| `workspace_id` | string | No | 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

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | string | No | 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/ |

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