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

# OneUp

> OneUp is a social media management platform for scheduling and managing posts, comments, connected accounts, media, and analytics across multiple social networks.

![OneUp logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/oneup.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=87862b05445886813dcd1e92e5b496d7)

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

## Tools

> [accordion] Comment On Post
>
> **Slug:** `ONEUP_COMMENT_ON_POST`
>
> Publish a new top-level comment on a social post through a connected OneUp social account.
>
> #### Input Parameters
>
> **comment** `string` *required*
>
> Text of the new top-level comment.
>
> **post\_id** `string` *required*
>
> Platform-specific ID of the post to comment on, as returned in post.post\_id by ONEUP\_LIST\_COMMENT\_THREADS. This is not the OneUp-internal post\_id from ONEUP\_LIST\_POSTS.
>
> **platform** `string ("facebook" | "instagram" | "tiktok" | "youtube" | "threads" | "linkedin" | "bluesky")` *required*
>
> Social platform containing the post.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp social account ID that will author the comment.
>
> #### 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 Image Post
>
> **Slug:** `ONEUP_CREATE_IMAGE_POST`
>
> Create a scheduled, timeslot, or draft image post for selected OneUp social accounts.
>
> #### Input Parameters
>
> **title** `string`
>
> Optional post title.
>
> **content** `string` *required*
>
> Post text or caption.
>
> **is\_draft** `boolean`
>
> Save the post as a draft instead of scheduling publication.
>
> **image\_urls** `array` *required*
>
> Public HTTP or HTTPS image URLs to attach in order.
>
> **category\_id** `integer` *required*
>
> OneUp category ID.
>
> **first\_comment** `string`
>
> Optional first comment on supported social networks.
>
> **publish\_to\_all** `boolean`
>
> Target every account in the category. Do not use with social\_account\_ids.
>
> **tiktok\_options** `object`
>
> Optional TikTok AI disclosure and music settings.
>
> **facebook\_options** `object`
>
> Optional Facebook Story and location settings.
>
> **snapchat\_options** `object`
>
> Optional Snapchat Spotlight settings.
>
> **instagram\_options** `object`
>
> Optional Instagram Story, collaborator, and location settings.
>
> **pinterest\_options** `object`
>
> Pinterest board targeting and optional destination link.
>
> **image\_to\_gbp\_photo** `boolean`
>
> Publish the image as a Google Business Profile photo when supported.
>
> **social\_account\_ids** `array`
>
> Specific social account IDs to target. Do not use with publish\_to\_all.
>
> **scheduled\_date\_time** `string` *required*
>
> Publish time as YYYY-MM-DD HH:MM, or `timeslot` on supported plans.
>
> **google\_business\_options** `object`
>
> Optional Google Business Profile post, call-to-action, event, or offer settings.
>
> #### 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 Media Upload URL
>
> **Slug:** `ONEUP_CREATE_MEDIA_UPLOAD_URL`
>
> Create a temporary OneUp media upload URL and return instructions for a separate direct upload. This tool does not upload media.
>
> #### 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 Text Post
>
> **Slug:** `ONEUP_CREATE_TEXT_POST`
>
> Create a scheduled, timeslot, or draft text post for selected OneUp social accounts.
>
> #### Input Parameters
>
> **title** `string`
>
> Optional post title.
>
> **content** `string` *required*
>
> Post text.
>
> **is\_draft** `boolean`
>
> Save as a draft instead of scheduling publication.
>
> **category\_id** `integer` *required*
>
> OneUp category ID.
>
> **first\_comment** `string`
>
> Optional first comment for supported social networks.
>
> **publish\_to\_all** `boolean`
>
> Publish to every enabled account in the category. Mutually exclusive with social\_account\_ids.
>
> **facebook\_options** `object`
>
> Optional Facebook location settings.
>
> **social\_account\_ids** `array`
>
> Specific social account IDs to publish to. Provide this or set publish\_to\_all=true, but not both.
>
> **scheduled\_date\_time** `string` *required*
>
> Publish time as YYYY-MM-DD HH:MM, or the literal timeslot to use a predefined OneUp timeslot.
>
> **google\_business\_options** `object`
>
> Optional Google Business Profile post, CTA, event, or offer settings.
>
> #### 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 Video Post
>
> **Slug:** `ONEUP_CREATE_VIDEO_POST`
>
> Create a scheduled, timeslot, or draft video post for selected OneUp social accounts.
>
> #### Input Parameters
>
> **title** `string`
>
> Optional post title.
>
> **content** `string` *required*
>
> Post text or caption.
>
> **is\_draft** `boolean`
>
> Save the post as a draft instead of scheduling it.
>
> **video\_url** `string` *required*
>
> Public video or Google Drive share URL.
>
> **category\_id** `integer` *required*
>
> OneUp category ID.
>
> **first\_comment** `string`
>
> Optional first comment for supported social networks.
>
> **thumbnail\_url** `string`
>
> Optional public thumbnail URL.
>
> **publish\_to\_all** `boolean`
>
> Target every account in the category; mutually exclusive with social\_account\_ids.
>
> **tiktok\_options** `object`
>
> TikTok disclosure and music options.
>
> **youtube\_options** `object`
>
> YouTube playlist targeting options.
>
> **facebook\_options** `object`
>
> Facebook Story, Reel, and location options.
>
> **snapchat\_options** `object`
>
> Snapchat Spotlight options.
>
> **instagram\_options** `object`
>
> Instagram Story, Reel, location, and music options.
>
> **pinterest\_options** `object`
>
> Pinterest board and destination options.
>
> **social\_account\_ids** `array`
>
> Specific social account IDs; use instead of publish\_to\_all.
>
> **scheduled\_date\_time** `string` *required*
>
> Publication time in YYYY-MM-DD HH:MM format, or timeslot.
>
> **google\_business\_options** `object`
>
> Google Business Profile post type, CTA, event, or offer options.
>
> #### 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 Comment
>
> **Slug:** `ONEUP_DELETE_COMMENT`
>
> Permanently and irreversibly delete a social-platform comment and its local OneUp record. This action cannot be undone.
>
> #### Input Parameters
>
> **post\_id** `string` *required*
>
> Platform-specific post ID containing the comment to permanently delete, as returned in post.post\_id by ONEUP\_LIST\_COMMENT\_THREADS. This is not the OneUp-internal post\_id from ONEUP\_LIST\_POSTS.
>
> **platform** `string ("facebook" | "instagram" | "tiktok" | "youtube" | "linkedin" | "bluesky")` *required*
>
> Social platform containing the comment to permanently delete.
>
> **comment\_id** `string` *required*
>
> Comment ID to permanently delete from the social platform and OneUp, as returned in comments\[].comment\_id by ONEUP\_LIST\_COMMENT\_THREADS. This operation cannot be undone.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp social account that owns or manages the comment.
>
> #### 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 Scheduled Post
>
> **Slug:** `ONEUP_DELETE_SCHEDULED_POST`
>
> Permanently and irreversibly delete an unpublished scheduled OneUp post. This action cannot be undone.
>
> #### Input Parameters
>
> **post\_id** `string` *required*
>
> Scheduled post ID from ONEUP\_LIST\_POSTS. The post is permanently and irreversibly deleted.
>
> #### 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] Edit Scheduled Post
>
> **Slug:** `ONEUP_EDIT_SCHEDULED_POST`
>
> Replace the content and optionally the title of a scheduled OneUp post.
>
> #### Input Parameters
>
> **title** `string`
>
> Replacement title, when the post type supports one.
>
> **content** `string` *required*
>
> Replacement content for the scheduled post.
>
> **post\_id** `string` *required*
>
> Scheduled post ID from ONEUP\_LIST\_POSTS.
>
> #### 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 Analytics Overview
>
> **Slug:** `ONEUP_GET_ANALYTICS_OVERVIEW`
>
> Get account-level overview metrics and ranked performance for a connected account on a supported social platform.
>
> #### Input Parameters
>
> **preset** `string ("last_7_days" | "last_30_days" | "last_90_days")`
>
> Preset reporting period. Use this alone, or omit it and provide both start\_date and end\_date.
>
> **end\_date** `string`
>
> Custom reporting-period end in YYYY-MM-DD format. It must be after start\_date and no later than yesterday.
>
> **platform** `string ("facebook" | "instagram" | "linkedin" | "threads" | "pinterest" | "snapchat" | "bluesky" | "tiktok" | "youtube" | "gbp" | "meta_ads")` *required*
>
> Social platform whose account-level analytics to return.
>
> **timezone** `string`
>
> IANA timezone used to interpret the reporting period.
>
> **start\_date** `string`
>
> Custom reporting-period start in YYYY-MM-DD format. Required with end\_date when preset is omitted.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp social account 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 Audience Demographics
>
> **Slug:** `ONEUP_GET_AUDIENCE_DEMOGRAPHICS`
>
> Get audience demographics for a connected Facebook, Instagram, TikTok, or YouTube account for a preset or custom reporting period.
>
> #### Input Parameters
>
> **preset** `string ("last_7_days" | "last_30_days" | "last_90_days")`
>
> Preset reporting period. Use this alone or provide both custom dates.
>
> **end\_date** `string`
>
> Custom reporting-period end in YYYY-MM-DD format. It must be after start\_date and no later than yesterday.
>
> **platform** `string ("facebook" | "instagram" | "tiktok" | "youtube")` *required*
>
> Social platform whose audience demographics to return.
>
> **timezone** `string`
>
> IANA timezone used to interpret the reporting period.
>
> **start\_date** `string`
>
> Custom reporting-period start in YYYY-MM-DD format. Pair it with end\_date.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp social account 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 Content Analytics
>
> **Slug:** `ONEUP_GET_CONTENT_ANALYTICS`
>
> Get per-post, Reel, or Story analytics for a connected account on a supported social platform.
>
> #### Input Parameters
>
> **preset** `string ("last_7_days" | "last_30_days" | "last_90_days")`
>
> Preset reporting period. Use this alone, or omit it and provide both start\_date and end\_date.
>
> **end\_date** `string`
>
> Custom reporting-period end in YYYY-MM-DD format. It must be after start\_date and no later than yesterday.
>
> **platform** `string ("facebook" | "instagram" | "linkedin" | "threads" | "pinterest" | "snapchat" | "bluesky" | "tiktok" | "youtube" | "gbp")` *required*
>
> Social platform whose content analytics to return.
>
> **timezone** `string`
>
> IANA timezone used to interpret the reporting period.
>
> **start\_date** `string`
>
> Custom reporting-period start in YYYY-MM-DD format. Required with end\_date when preset is omitted.
>
> **content\_type** `string ("posts" | "reels" | "stories")`
>
> Content family to analyze. Reels are supported only for Facebook; stories are supported only for Facebook and Instagram.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp social account 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 Google Business Reviews
>
> **Slug:** `ONEUP_GET_GOOGLE_BUSINESS_REVIEWS`
>
> Get Google Business Profile reviews and aggregate rating information for a connected account or location.
>
> #### Input Parameters
>
> **preset** `string ("last_7_days" | "last_30_days" | "last_90_days")`
>
> Preset review period. Use this alone, or omit it and provide both start\_date and end\_date.
>
> **end\_date** `string`
>
> Custom review-period end in YYYY-MM-DD format. It must be after start\_date and no later than yesterday.
>
> **timezone** `string`
>
> IANA timezone used to interpret the review period.
>
> **start\_date** `string`
>
> Custom review-period start in YYYY-MM-DD format. Required with end\_date when preset is omitted.
>
> **social\_account\_id** `string` *required*
>
> Connected Google Business Profile account or location 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 Meta Ads Analytics
>
> **Slug:** `ONEUP_GET_META_ADS_ANALYTICS`
>
> Get campaign, ad-set, or individual-ad analytics for a connected Meta Ads account.
>
> #### Input Parameters
>
> **level** `string ("campaigns" | "ad_sets" | "ads")` *required*
>
> Meta Ads reporting level to return.
>
> **preset** `string ("last_7_days" | "last_30_days" | "last_90_days")`
>
> Preset reporting period. Use this alone, or omit it and provide both start\_date and end\_date.
>
> **end\_date** `string`
>
> Custom reporting-period end in YYYY-MM-DD format. It must be after start\_date and no later than yesterday.
>
> **timezone** `string`
>
> IANA timezone used to interpret the reporting period.
>
> **start\_date** `string`
>
> Custom reporting-period start in YYYY-MM-DD format. Required with end\_date when preset is omitted.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp Meta Ads account 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] List Categories
>
> **Slug:** `ONEUP_LIST_CATEGORIES`
>
> List OneUp categories used to group connected social accounts.
>
> #### 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 Category Accounts
>
> **Slug:** `ONEUP_LIST_CATEGORY_ACCOUNTS`
>
> List social accounts assigned to a OneUp category. An unknown category and a category with no accounts both return an empty list.
>
> #### Input Parameters
>
> **category\_id** `integer` *required*
>
> Category ID returned by ONEUP\_LIST\_CATEGORIES.
>
> #### 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 Comment Replies
>
> **Slug:** `ONEUP_LIST_COMMENT_REPLIES`
>
> Fetch child replies for a parent social-platform comment.
>
> #### Input Parameters
>
> **comment\_id** `string` *required*
>
> Parent comment ID returned by ONEUP\_LIST\_COMMENT\_THREADS.
>
> #### 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 Comment Threads
>
> **Slug:** `ONEUP_LIST_COMMENT_THREADS`
>
> List social posts with top-level comments and child replies in the requested order, one page at a time. A processing status means OneUp is still preparing the data and the read should be retried later.
>
> #### Input Parameters
>
> **filter** `string ("recent_comment" | "latest" | "oldest")`
>
> Thread ordering: recent\_comment prioritizes new non-owner comments; latest and oldest order by post publication date.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a prior call. Omit for the first page and pass it back unchanged to continue.
>
> #### 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 Instagram Trending Sounds
>
> **Slug:** `ONEUP_LIST_INSTAGRAM_TRENDING_SOUNDS`
>
> Search Instagram trending sounds for a Facebook-connected Instagram Business or Creator account.
>
> #### Input Parameters
>
> **search\_query** `string` *required*
>
> Sound search text required by OneUp's current API.
>
> **social\_account\_id** `string` *required*
>
> Facebook-connected Instagram Business or Creator account 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] List Pinterest Boards
>
> **Slug:** `ONEUP_LIST_PINTEREST_BOARDS`
>
> List boards available to a connected Pinterest username for post targeting. Use a returned board name and ID when creating an image or video post.
>
> #### Input Parameters
>
> **pinterest\_username** `string` *required*
>
> Connected Pinterest username whose boards to list.
>
> #### 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:** `ONEUP_LIST_POSTS`
>
> List scheduled, published, or failed OneUp posts, one page at a time.
>
> #### Input Parameters
>
> **status** `string ("scheduled" | "published" | "failed")` *required*
>
> Post queue to list: scheduled, published, or failed.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous LIST\_POSTS call. Omit for the first page and keep the same status when continuing.
>
> #### 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 Social Accounts
>
> **Slug:** `ONEUP_LIST_SOCIAL_ACCOUNTS`
>
> List all connected OneUp social accounts and their connection health.
>
> #### 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 TikTok Trending Sounds
>
> **Slug:** `ONEUP_LIST_TIKTOK_TRENDING_SOUNDS`
>
> Get TikTok trending commercial sounds for a documented country, period, genre, and connected TikTok account.
>
> #### Input Parameters
>
> **genre** `string ("ALL" | "ROCK" | "POP" | "LATIN" | "METAL" | "ELECTRONIC" | "HIP_HOP_RAP" | "ALTERNATIVE_INDIE" | "FOLK" | "R_B_SOUL" | "COUNTRY" | "CLASSICAL" | "JAZZ" | "REGGAE" | "CHILDHOOD" | "BLUES" | "EASY_LISTENING" | "NEW_AGE" | "WORLD_MUSIC" | "EXPERIMENTAL" | "DEVOTIONAL" | "CHINESE_TRADITION" | "8_BIT" | "A_CAPPELLA" | "AFRO_POP" | "ALTERNATIVE_HIP_HOP" | "ALTERNATIVE_ROCK" | "AMBIENT" | "ARABIC_POP" | "BASS_HOUSE" | "BGM" | "BOOMBAP" | "BOSSA_NOVA" | "BRAZILIAN_FUNK_STYLE" | "BUDDHIST_MUSIC" | "CANTOPOP" | "CELTIC_POP" | "CHAMBER_MUSIC" | "CHILL_BEATS" | "CHILLOUT" | "CHINESE_FOLK" | "CHINESE_OPERA" | "CHINESE_POP" | "CHINESE_STYLE" | "CHINOISERIE_ELECTRONIC" | "CHINOISERIE_RAP" | "CHRISTIAN_MUSIC" | "CONTEMPORARY_R_B" | "COUNTRY_POP" | "DANCE_POP" | "DISCO" | "DJ" | "DRUM_BASS" | "DUBSTEP" | "EDM" | "EDM_TRAP" | "ELECTRO_POP" | "EPIC" | "FOLK_POP" | "FUNK" | "FUTURE_BASS" | "GOSPEL" | "GUFENG_MUSIC" | "HARD_ROCK" | "HIP_HOUSE" | "HOLIDAY_MUSIC" | "HOUSE" | "INDIAN_POP" | "INDIE_FOLK" | "INDIE_POP" | "INDIE_ROCK" | "INSTRUMENTAL_HIP_HOP" | "INSTRUMENTAL_ROCK" | "IRISH_FOLK" | "J_ROCK" | "JAPANESE_TRADITIONAL_MUSIC" | "JAZZ_FUSION" | "JAZZ_HIP_HOP" | "JAZZ_POP" | "J_POP" | "K_POP" | "LATIN_POP" | "LO_FI" | "MC" | "NOISE" | "OLD_SCHOOL" | "OTHERS" | "POP_RAP" | "POP_ROCK" | "POP_SOUL" | "PSYCHEDELIC_ROCK" | "PUNK" | "R_B_RAP" | "REGGAETON" | "RUSSIAN_POP" | "SERTANEJO" | "SON_CUBANO" | "SOUL" | "SOUNDTRACK" | "SYMPHONY" | "SYNTH_POP" | "TANGO" | "TECHNO" | "TEEN_POP" | "TRADITIONAL_CHINESE_FOLK" | "TRANCE" | "TRAP_RAP" | "TRIP_HOP" | "TROPICAL_HOUSE" | "TURKISH_POP")` *required*
>
> TikTok commercial music genre, or ALL for every genre.
>
> **date\_range** `string ("1DAY" | "7DAY" | "30DAY" | "90DAY")` *required*
>
> Period over which TikTok sound trends are ranked.
>
> **country\_code** `string ("US" | "AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AO" | "AQ" | "AR" | "AS" | "AT" | "AU" | "AW" | "AX" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BQ" | "BR" | "BS" | "BT" | "BV" | "BW" | "BY" | "BZ" | "CA" | "CC" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CX" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "EH" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FM" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GF" | "GG" | "GH" | "GI" | "GL" | "GM" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GU" | "GW" | "GY" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IM" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MG" | "MH" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PN" | "PR" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SH" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SY" | "SZ" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "UY" | "UZ" | "VA" | "VC" | "VE" | "VG" | "VI" | "VN" | "VU" | "WF" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW")` *required*
>
> Country whose TikTok commercial sound trends to return.
>
> **social\_account\_id** `string` *required*
>
> Connected TikTok social account ID from ONEUP\_LIST\_SOCIAL\_ACCOUNTS.
>
> #### 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 YouTube Playlists
>
> **Slug:** `ONEUP_LIST_YOUTUBE_PLAYLISTS`
>
> List playlists for a connected YouTube channel. Use a returned playlist name and ID when targeting a video post.
>
> #### Input Parameters
>
> **social\_account\_id** `string` *required*
>
> Connected YouTube account ID from ONEUP\_LIST\_SOCIAL\_ACCOUNTS.
>
> #### 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] Refresh Analytics
>
> **Slug:** `ONEUP_REFRESH_ANALYTICS`
>
> Start a background refresh of analytics for all connected social accounts. Returns immediately with the provider's status and progress; it does not poll or retry.
>
> #### 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] Refresh Comments
>
> **Slug:** `ONEUP_REFRESH_COMMENTS`
>
> Start a background refresh of comments from connected social platforms. Returns immediately with started, already\_in\_progress, or cooldown status; it does not poll or retry.
>
> #### 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] Reply To Comment
>
> **Slug:** `ONEUP_REPLY_TO_COMMENT`
>
> Publish a direct reply to an existing social-platform comment.
>
> #### Input Parameters
>
> **comment** `string` *required*
>
> Text of the reply to publish.
>
> **post\_id** `string` *required*
>
> Platform-specific ID of the post containing the comment, as returned in post.post\_id by ONEUP\_LIST\_COMMENT\_THREADS. This is not the OneUp-internal post\_id from ONEUP\_LIST\_POSTS.
>
> **platform** `string` *required*
>
> Exact platform value returned by ONEUP\_LIST\_COMMENT\_THREADS for the source comment. Pass it through unchanged; do not guess or normalize it.
>
> **parent\_comment\_id** `string` *required*
>
> Platform-specific ID of the comment to reply to, as returned in comments\[].comment\_id by ONEUP\_LIST\_COMMENT\_THREADS.
>
> **social\_account\_id** `string` *required*
>
> Connected OneUp social account that will author the reply.
>
> #### 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] Reschedule Failed Post
>
> **Slug:** `ONEUP_RESCHEDULE_FAILED_POST`
>
> Move a failed post back into the schedule at a future date and time.
>
> #### Input Parameters
>
> **post\_id** `string` *required*
>
> Failed post ID returned by ONEUP\_LIST\_POSTS.
>
> **scheduled\_date\_time** `string` *required*
>
> Future publication time in YYYY-MM-DD HH:MM format.
>
> #### 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
