Dash Social

Fetch community messages (comments, DMs, mentions) for one or more Dash Social brands. Returns per message: interaction ID, link to Dash Social, interaction type (e.g. INSTAGRAM_COMMENT, INSTAGRAM_CONVERSATION), text snippet, author handle, conversation ID for DMs, sentiment label, assignee, tags, triggered automation rules, and brand name. Use this to search, analyze, or summarize community interactions by date range, keyword, sentiment, or type.

get_community_messages

Look up Dash Social users who have access to one or more brands. Use this when you need to resolve a person's name to a user ID before taking a follow-up action — assigning a community task, setting a scheduled post approver, or any other workflow that requires a user ID. Supports case-insensitive partial name matching. Returns id and full_name for each user.

get_dash_social_users

List the brand's native Pinterest boards, which are publishing destinations on Pinterest itself. Use this tool only when creating or editing a Pinterest Pin, and pass the full board object to the scheduler tool. Dash Social boards are internal collections used to organize and report on content; use search_galleries to find those.

get_pinterest_boards

Lists all brands the authenticated user has access to. Returns each brand's id, name, and organization_id. Call this tool when the user asks which brands they have access to, or when you need a brand id to pass to another tool.

list_accessible_brands

List scheduler posts for a single Dash Social brand and social channel. Scheduled posts are sorted by scheduled time, from soonest to latest. Unscheduled posts are sorted by their order in Dash Social. When referencing a post that has a dash_url, present the dash_url as a markdown link so the user can open the post in Dash Social. If dash_url is null, do not construct or guess a URL.

list_scheduled_posts

Schedule a social post as a draft for a single Dash Social brand. The post is always created in DRAFT state and cannot publish while it remains a draft. Default auto_publish to true unless the user explicitly requests notification/manual publishing. When referencing a post that has a dash_url, present the dash_url as a markdown link so the user can open the post in Dash Social. If dash_url is null, do not construct or guess a URL.

schedule_post

Look up brand tags that can be used to report on a group of brands at once. Brand tags are organization-level groupings of brands (e.g. by region or portfolio).

search_brand_tags

Resolve competitors that brands already track in Dash Social. Use this when a client needs competitor source account IDs for downstream competitive reports, benchmarking, or competitor media filters. Results only include accounts already saved on the requested Dash Social brands; this is not discovery or autocomplete for new external accounts. Search terms match saved account handles only.

search_competitors

Look up content tags that can be used to filter data or content.

search_content_tags

Search campaigns created in Dash Social for a brand.

search_campaigns

Search galleries or boards created in Dash Social for a brand. Galleries are general-purpose content collections; Dash Social boards are channel-specific collections used to organize and report on content. Use this tool to find Dash Social boards for any channel. Dash Social boards are distinct from the native Pinterest publishing destinations returned by get_pinterest_boards.

search_galleries

Find locations for Instagram or Facebook scheduled posts. Choose whether the location will tag a post or limit a Facebook post's audience.

search_locations

Search Dash Social metrics for report keys and post sort fields. Use usage="aggregate_report" when building total or grouped metric reports, and pass result.metric_key to fetch_ads_metric_report.metrics for META_ADS or TIKTOK_ADS; for other channels, pass it to fetch_metric_report.metrics. Use usage="time_series_report" when building line graph or other time series reports, and pass result.metric_key to fetch_timeseries_metric_report.metrics. Use usage="sorting_posts" before sorting posts by a performance metric. In this mode, pass result.sort_metric_key to search_posts.sort_metric_key. Do not pass result.metric_key to search_posts; for sorting_posts, metric_key is the dashboard content metric key and sort_metric_key is the library sort field. When multiple channels are requested, results only include metrics comparable across every channel in the search. Each result includes aggregate_by_options for choosing an optional grouping dimension. Benchmark search results are only for industry benchmark reporting; never pass them to fetch_metric_report or fetch_timeseries_metric_report. When a result includes aggregate="AVERAGE", pass both result.metric_key and result.aggregate to the matching fetch tool. Use averageable=true to limit results to metrics that can be averaged with aggregate=AVERAGE or metrics dashboard already defines as averages. Use timeframe to filter how the report date range applies to the metric. Each result may include timeframe; use it to understand how the report date range applies to that metric.

search_metrics

Search social posts and uploaded media across Dash Social brands. Use this when you need to find matching owned, UGC, saved competitor, or uploaded media and inspect post-level metadata, captions, URLs, media details, or available metrics. Results are sorted by date by default. Fuzzy searches without metric sorting rank by relevance instead. To sort by a performance metric, first call search_metrics with usage="sorting_posts" for the same channel surface, then pass the returned sort_metric_key. When sorting competitor posts, use the competitive channel variant in search_metrics.

search_posts

Upload image or video URLs to one or more Dash Social brand libraries. Each item is attached to every requested brand and processed independently. Use the returned media IDs when scheduling, and retry only the failed items.

upload_media