Skip to main content
OneUp logo
  • Category: social media marketing
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 27
  • Triggers: 0
  • Slug: ONEUP
  • Version: 20261030_00

Tools

Slug: ONEUP_COMMENT_ON_POSTPublish a new top-level comment on a social post through a connected OneUp social account.

Input Parameters

string
required
Text of the new top-level comment.
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.
string ("facebook" | "instagram" | "tiktok" | "youtube" | "threads" | "linkedin" | "bluesky")
required
Social platform containing the post.
string
required
Connected OneUp social account ID that will author the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_CREATE_IMAGE_POSTCreate a scheduled, timeslot, or draft image post for selected OneUp social accounts.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_CREATE_MEDIA_UPLOAD_URLCreate a temporary OneUp media upload URL and return instructions for a separate direct upload. This tool does not upload media.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_CREATE_TEXT_POSTCreate a scheduled, timeslot, or draft text post for selected OneUp social accounts.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_CREATE_VIDEO_POSTCreate a scheduled, timeslot, or draft video post for selected OneUp social accounts.

Input Parameters

string
Optional post title.
string
required
Post text or caption.
boolean
Save the post as a draft instead of scheduling it.
string
required
Public video or Google Drive share URL.
integer
required
OneUp category ID.
string
Optional first comment for supported social networks.
string
Optional public thumbnail URL.
boolean
Target every account in the category; mutually exclusive with social_account_ids.
object
TikTok disclosure and music options.
object
YouTube playlist targeting options.
object
Facebook Story, Reel, and location options.
object
Snapchat Spotlight options.
object
Instagram Story, Reel, location, and music options.
object
Pinterest board and destination options.
array
Specific social account IDs; use instead of publish_to_all.
string
required
Publication time in YYYY-MM-DD HH:MM format, or timeslot.
object
Google Business Profile post type, CTA, event, or offer options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_DELETE_COMMENTPermanently and irreversibly delete a social-platform comment and its local OneUp record. This action cannot be undone.

Input Parameters

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.
string ("facebook" | "instagram" | "tiktok" | "youtube" | "linkedin" | "bluesky")
required
Social platform containing the comment to permanently delete.
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.
string
required
Connected OneUp social account that owns or manages the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_DELETE_SCHEDULED_POSTPermanently and irreversibly delete an unpublished scheduled OneUp post. This action cannot be undone.

Input Parameters

string
required
Scheduled post ID from ONEUP_LIST_POSTS. The post is permanently and irreversibly deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_EDIT_SCHEDULED_POSTReplace the content and optionally the title of a scheduled OneUp post.

Input Parameters

string
Replacement title, when the post type supports one.
string
required
Replacement content for the scheduled post.
string
required
Scheduled post ID from ONEUP_LIST_POSTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_GET_ANALYTICS_OVERVIEWGet account-level overview metrics and ranked performance for a connected account on a supported social platform.

Input Parameters

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.
string
Custom reporting-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday.
string ("facebook" | "instagram" | "linkedin" | "threads" | "pinterest" | "snapchat" | "bluesky" | "tiktok" | "youtube" | "gbp" | "meta_ads")
required
Social platform whose account-level analytics to return.
string
IANA timezone used to interpret the reporting period.
string
Custom reporting-period start in YYYY-MM-DD format. Required with end_date when preset is omitted.
string
required
Connected OneUp social account ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_GET_AUDIENCE_DEMOGRAPHICSGet audience demographics for a connected Facebook, Instagram, TikTok, or YouTube account for a preset or custom reporting period.

Input Parameters

string ("last_7_days" | "last_30_days" | "last_90_days")
Preset reporting period. Use this alone or provide both custom dates.
string
Custom reporting-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday.
string ("facebook" | "instagram" | "tiktok" | "youtube")
required
Social platform whose audience demographics to return.
string
IANA timezone used to interpret the reporting period.
string
Custom reporting-period start in YYYY-MM-DD format. Pair it with end_date.
string
required
Connected OneUp social account ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_GET_CONTENT_ANALYTICSGet per-post, Reel, or Story analytics for a connected account on a supported social platform.

Input Parameters

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.
string
Custom reporting-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday.
string ("facebook" | "instagram" | "linkedin" | "threads" | "pinterest" | "snapchat" | "bluesky" | "tiktok" | "youtube" | "gbp")
required
Social platform whose content analytics to return.
string
IANA timezone used to interpret the reporting period.
string
Custom reporting-period start in YYYY-MM-DD format. Required with end_date when preset is omitted.
string ("posts" | "reels" | "stories")
Content family to analyze. Reels are supported only for Facebook; stories are supported only for Facebook and Instagram.
string
required
Connected OneUp social account ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_GET_GOOGLE_BUSINESS_REVIEWSGet Google Business Profile reviews and aggregate rating information for a connected account or location.

Input Parameters

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.
string
Custom review-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday.
string
IANA timezone used to interpret the review period.
string
Custom review-period start in YYYY-MM-DD format. Required with end_date when preset is omitted.
string
required
Connected Google Business Profile account or location ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_GET_META_ADS_ANALYTICSGet campaign, ad-set, or individual-ad analytics for a connected Meta Ads account.

Input Parameters

string ("campaigns" | "ad_sets" | "ads")
required
Meta Ads reporting level to return.
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.
string
Custom reporting-period end in YYYY-MM-DD format. It must be after start_date and no later than yesterday.
string
IANA timezone used to interpret the reporting period.
string
Custom reporting-period start in YYYY-MM-DD format. Required with end_date when preset is omitted.
string
required
Connected OneUp Meta Ads account ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_CATEGORIESList OneUp categories used to group connected social accounts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_CATEGORY_ACCOUNTSList social accounts assigned to a OneUp category. An unknown category and a category with no accounts both return an empty list.

Input Parameters

integer
required
Category ID returned by ONEUP_LIST_CATEGORIES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_COMMENT_REPLIESFetch child replies for a parent social-platform comment.

Input Parameters

string
required
Parent comment ID returned by ONEUP_LIST_COMMENT_THREADS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_COMMENT_THREADSList 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_PINTEREST_BOARDSList 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

string
required
Connected Pinterest username whose boards to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_POSTSList scheduled, published, or failed OneUp posts, one page at a time.

Input Parameters

string ("scheduled" | "published" | "failed")
required
Post queue to list: scheduled, published, or failed.
string
Opaque continuation cursor returned by a previous LIST_POSTS call. Omit for the first page and keep the same status when continuing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_SOCIAL_ACCOUNTSList all connected OneUp social accounts and their connection health.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_LIST_YOUTUBE_PLAYLISTSList playlists for a connected YouTube channel. Use a returned playlist name and ID when targeting a video post.

Input Parameters

string
required
Connected YouTube account ID from ONEUP_LIST_SOCIAL_ACCOUNTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_REFRESH_ANALYTICSStart 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_REFRESH_COMMENTSStart 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_REPLY_TO_COMMENTPublish a direct reply to an existing social-platform comment.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONEUP_RESCHEDULE_FAILED_POSTMove a failed post back into the schedule at a future date and time.

Input Parameters

string
required
Failed post ID returned by ONEUP_LIST_POSTS.
string
required
Future publication time in YYYY-MM-DD HH:MM format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not