---
canonical_url: "https://docs.composio.dev/toolkits/oneup"
markdown_url: "https://docs.composio.dev/toolkits/oneup.md"
product: "platform"
version: null
last_updated: null
---

# OneUp

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

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

## Tools

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | string | Yes | Text of the new top-level comment. |
| `post_id` | string | Yes | 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") | Yes | Social platform containing the post. |
| `social_account_id` | string | Yes | Connected OneUp social account ID that will author the comment. |

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

### Create Image Post

**Slug:** `ONEUP_CREATE_IMAGE_POST`

Create a scheduled, timeslot, or draft image post for selected OneUp social accounts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Optional post title. |
| `content` | string | Yes | Post text or caption. |
| `is_draft` | boolean | No | Save the post as a draft instead of scheduling publication. |
| `image_urls` | array | Yes | Public HTTP or HTTPS image URLs to attach in order. |
| `category_id` | integer | Yes | OneUp category ID. |
| `first_comment` | string | No | Optional first comment on supported social networks. |
| `publish_to_all` | boolean | No | Target every account in the category. Do not use with social_account_ids. |
| `tiktok_options` | object | No | Optional TikTok AI disclosure and music settings. |
| `facebook_options` | object | No | Optional Facebook Story and location settings. |
| `snapchat_options` | object | No | Optional Snapchat Spotlight settings. |
| `instagram_options` | object | No | Optional Instagram Story, collaborator, and location settings. |
| `pinterest_options` | object | No | Pinterest board targeting and optional destination link. |
| `image_to_gbp_photo` | boolean | No | Publish the image as a Google Business Profile photo when supported. |
| `social_account_ids` | array | No | Specific social account IDs to target. Do not use with publish_to_all. |
| `scheduled_date_time` | string | Yes | Publish time as YYYY-MM-DD HH:MM, or `timeslot` on supported plans. |
| `google_business_options` | object | No | Optional Google Business Profile post, call-to-action, event, or offer settings. |

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

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

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

### Create Text Post

**Slug:** `ONEUP_CREATE_TEXT_POST`

Create a scheduled, timeslot, or draft text post for selected OneUp social accounts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Optional post title. |
| `content` | string | Yes | Post text. |
| `is_draft` | boolean | No | Save as a draft instead of scheduling publication. |
| `category_id` | integer | Yes | OneUp category ID. |
| `first_comment` | string | No | Optional first comment for supported social networks. |
| `publish_to_all` | boolean | No | Publish to every enabled account in the category. Mutually exclusive with social_account_ids. |
| `facebook_options` | object | No | Optional Facebook location settings. |
| `social_account_ids` | array | No | Specific social account IDs to publish to. Provide this or set publish_to_all=true, but not both. |
| `scheduled_date_time` | string | Yes | Publish time as YYYY-MM-DD HH:MM, or the literal timeslot to use a predefined OneUp timeslot. |
| `google_business_options` | object | No | Optional Google Business Profile post, CTA, event, or offer settings. |

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

### Create Video Post

**Slug:** `ONEUP_CREATE_VIDEO_POST`

Create a scheduled, timeslot, or draft video post for selected OneUp social accounts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Optional post title. |
| `content` | string | Yes | Post text or caption. |
| `is_draft` | boolean | No | Save the post as a draft instead of scheduling it. |
| `video_url` | string | Yes | Public video or Google Drive share URL. |
| `category_id` | integer | Yes | OneUp category ID. |
| `first_comment` | string | No | Optional first comment for supported social networks. |
| `thumbnail_url` | string | No | Optional public thumbnail URL. |
| `publish_to_all` | boolean | No | Target every account in the category; mutually exclusive with social_account_ids. |
| `tiktok_options` | object | No | TikTok disclosure and music options. |
| `youtube_options` | object | No | YouTube playlist targeting options. |
| `facebook_options` | object | No | Facebook Story, Reel, and location options. |
| `snapchat_options` | object | No | Snapchat Spotlight options. |
| `instagram_options` | object | No | Instagram Story, Reel, location, and music options. |
| `pinterest_options` | object | No | Pinterest board and destination options. |
| `social_account_ids` | array | No | Specific social account IDs; use instead of publish_to_all. |
| `scheduled_date_time` | string | Yes | Publication time in YYYY-MM-DD HH:MM format, or timeslot. |
| `google_business_options` | object | No | Google Business Profile post type, CTA, event, or offer options. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | 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") | Yes | Social platform containing the comment to permanently delete. |
| `comment_id` | string | Yes | 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 | Yes | Connected OneUp social account that owns or manages the comment. |

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

**Slug:** `ONEUP_DELETE_SCHEDULED_POST`

Permanently and irreversibly delete an unpublished scheduled OneUp post. This action cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Scheduled post ID from ONEUP_LIST_POSTS. The post is permanently and irreversibly deleted. |

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

### Edit Scheduled Post

**Slug:** `ONEUP_EDIT_SCHEDULED_POST`

Replace the content and optionally the title of a scheduled OneUp post.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Replacement title, when the post type supports one. |
| `content` | string | Yes | Replacement content for the scheduled post. |
| `post_id` | string | Yes | Scheduled post ID from ONEUP_LIST_POSTS. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `preset` | string ("last_7_days" | "last_30_days" | "last_90_days") | No | Preset reporting period. Use this alone, or omit it and provide both start_date and end_date. |
| `end_date` | string | No | 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") | Yes | Social platform whose account-level analytics to return. |
| `timezone` | string | No | IANA timezone used to interpret the reporting period. |
| `start_date` | string | No | Custom reporting-period start in YYYY-MM-DD format. Required with end_date when preset is omitted. |
| `social_account_id` | string | Yes | Connected OneUp social account 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `preset` | string ("last_7_days" | "last_30_days" | "last_90_days") | No | Preset reporting period. Use this alone or provide both custom dates. |
| `end_date` | string | No | 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") | Yes | Social platform whose audience demographics to return. |
| `timezone` | string | No | IANA timezone used to interpret the reporting period. |
| `start_date` | string | No | Custom reporting-period start in YYYY-MM-DD format. Pair it with end_date. |
| `social_account_id` | string | Yes | Connected OneUp social account 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `preset` | string ("last_7_days" | "last_30_days" | "last_90_days") | No | Preset reporting period. Use this alone, or omit it and provide both start_date and end_date. |
| `end_date` | string | No | 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") | Yes | Social platform whose content analytics to return. |
| `timezone` | string | No | IANA timezone used to interpret the reporting period. |
| `start_date` | string | No | Custom reporting-period start in YYYY-MM-DD format. Required with end_date when preset is omitted. |
| `content_type` | string ("posts" | "reels" | "stories") | No | Content family to analyze. Reels are supported only for Facebook; stories are supported only for Facebook and Instagram. |
| `social_account_id` | string | Yes | Connected OneUp social account 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `preset` | string ("last_7_days" | "last_30_days" | "last_90_days") | No | Preset review period. Use this alone, or omit it and provide both start_date and end_date. |
| `end_date` | string | No | Custom review-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday. |
| `timezone` | string | No | IANA timezone used to interpret the review period. |
| `start_date` | string | No | Custom review-period start in YYYY-MM-DD format. Required with end_date when preset is omitted. |
| `social_account_id` | string | Yes | Connected Google Business Profile account or location 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `level` | string ("campaigns" | "ad_sets" | "ads") | Yes | Meta Ads reporting level to return. |
| `preset` | string ("last_7_days" | "last_30_days" | "last_90_days") | No | Preset reporting period. Use this alone, or omit it and provide both start_date and end_date. |
| `end_date` | string | No | Custom reporting-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday. |
| `timezone` | string | No | IANA timezone used to interpret the reporting period. |
| `start_date` | string | No | Custom reporting-period start in YYYY-MM-DD format. Required with end_date when preset is omitted. |
| `social_account_id` | string | Yes | Connected OneUp Meta Ads account 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 |

### List Categories

**Slug:** `ONEUP_LIST_CATEGORIES`

List OneUp categories used to group connected social accounts.

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category_id` | integer | Yes | Category ID returned by ONEUP_LIST_CATEGORIES. |

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

**Slug:** `ONEUP_LIST_COMMENT_REPLIES`

Fetch child replies for a parent social-platform comment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Parent comment ID returned by ONEUP_LIST_COMMENT_THREADS. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string ("recent_comment" | "latest" | "oldest") | No | Thread ordering: recent_comment prioritizes new non-owner comments; latest and oldest order by post publication date. |
| `next_cursor` | string | No | Continuation cursor returned by a prior call. Omit for the first page and pass it back unchanged to continue. |

#### 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 Instagram Trending Sounds

**Slug:** `ONEUP_LIST_INSTAGRAM_TRENDING_SOUNDS`

Search Instagram trending sounds for a Facebook-connected Instagram Business or Creator account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search_query` | string | Yes | Sound search text required by OneUp's current API. |
| `social_account_id` | string | Yes | Facebook-connected Instagram Business or Creator account 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pinterest_username` | string | Yes | Connected Pinterest username whose boards to list. |

#### 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:** `ONEUP_LIST_POSTS`

List scheduled, published, or failed OneUp posts, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("scheduled" | "published" | "failed") | Yes | Post queue to list: scheduled, published, or failed. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous LIST_POSTS call. Omit for the first page and keep the same status when continuing. |

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

**Slug:** `ONEUP_LIST_SOCIAL_ACCOUNTS`

List all connected OneUp social accounts and their connection health.

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `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") | Yes | TikTok commercial music genre, or ALL for every genre. |
| `date_range` | string ("1DAY" | "7DAY" | "30DAY" | "90DAY") | Yes | 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") | Yes | Country whose TikTok commercial sound trends to return. |
| `social_account_id` | string | Yes | Connected TikTok social account ID from ONEUP_LIST_SOCIAL_ACCOUNTS. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `social_account_id` | string | Yes | Connected YouTube account ID from ONEUP_LIST_SOCIAL_ACCOUNTS. |

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

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

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

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

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

### Reply To Comment

**Slug:** `ONEUP_REPLY_TO_COMMENT`

Publish a direct reply to an existing social-platform comment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | string | Yes | Text of the reply to publish. |
| `post_id` | string | Yes | 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 | Yes | 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 | Yes | Platform-specific ID of the comment to reply to, as returned in comments[].comment_id by ONEUP_LIST_COMMENT_THREADS. |
| `social_account_id` | string | Yes | Connected OneUp social account that will author the reply. |

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

### Reschedule Failed Post

**Slug:** `ONEUP_RESCHEDULE_FAILED_POST`

Move a failed post back into the schedule at a future date and time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Failed post ID returned by ONEUP_LIST_POSTS. |
| `scheduled_date_time` | string | Yes | Future publication time in YYYY-MM-DD HH:MM format. |

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