NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Dotsimple connects to a Nagent workspace with an API key. Once it is connected, agents can call 11 Dotsimple actions, such as "Create Tag", "Get Media File" and "Get Tag by UUID". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Dotsimple, with input parameters and output schema.
DOTSIMPLE_CREATE_TAGCreate 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
The name of the tag to be created. Used to categorize and filter content in DotSimple.
Hexadecimal color code for the tag in format '#RRGGBB'. Must include the '#' prefix followed by exactly 6 hexadecimal digits. Example: '#38bdf8' for sky blue.
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_DELETE_MEDIA_FILESDeletes 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
Array of media file IDs (as strings) to delete from the workspace
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_DELETE_TAGDelete 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
UUID of the tag to delete
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_GET_MEDIA_FILETool to retrieve details of a specific media file. Use when you have the mediaFileId and need its metadata.
Input parameters
The unique identifier of the media file
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_GET_TAGTool to retrieve details for a specific tag by UUID. Use when you need full tag information after obtaining its identifier.
Input parameters
The UUID of the tag to retrieve
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_LIST_ACCOUNTSList 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
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_LIST_AUTORESPONDERSList 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 number for pagination (1-indexed).
Number of items to return per page.
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_LIST_MEDIA_FILESList 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
Page number for pagination
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_LIST_POSTSList 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
Page number to retrieve (1-indexed)
Number of posts per page
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_LIST_REPORTSList 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 number to retrieve (1-indexed)
Number of report entries per page
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOTSIMPLE_LIST_TAGSList 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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 11 Dotsimple actions on Nagent, including "Create Tag", "Get Media File" and "Get Tag by UUID". Create Tag: Create a new tag in DotSimple workspace for categorizing and organizing social media content. Each action is listed on this page with its input parameters and its output.
Dotsimple connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Tag takes 2 required inputs: name and hex_color. It also takes 1 optional input: workspace_id. It returns data, error and successful.