Reference

Tool reference

33 tools across 5 surfaces. Each entry shows the tool name, what it does, and its input parameters as exposed via tools/list.

Generation

Create images, videos, funnels, and creative insights.

vibiz_generate_image

Generate ONE static ad IMAGE (no motion, no sound).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
Describe the STATIC IMAGE to generate. Do not structure as storyboard/frames.
platformstring
Target platform. MUST be one of the listed values. Common mappings: TikTok → "tiktok_story", Instagram feed → "instagram_portrait", Instagram story → "instagram_story", Facebook → "facebook_feed", LinkedIn → "linkedin". Default: "instagram_portrait".
Values: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic
aspectRatiostring
Optional. If omitted, derived from `platform`. 9:16 = vertical, 1:1 = square, 16:9 = landscape.
Values: 1:1, 16:9, 9:16, 4:5, 3:2
stylestring
Per-app style key. "branded-ad" is the default marketing ad style.
Values: branded-ad, shots, hyperrealistic, infographic, ecommerce-product
useBrandboolean
Apply the workspace brand kit (colors, fonts, logo, tone). Default true. Set false only if the user explicitly wants a generic look.
imageCountinteger
Number of VARIATIONS of the SAME image to generate (1-4). Default 1. NOT for making a video storyboard — use `vibiz_generate_ugc` for motion content.

vibiz_generate_carousel

Generate a multi-slide marketing CAROUSEL (hook → story → CTA) for Instagram, LinkedIn, or similar slide-based placements. Each slide is its own image; they ship as one cohesive set.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
What the carousel is about: topic, angle, key message. The generator writes per-slide copy — you describe the story, not the individual slides.
slideCountinteger
Number of slides (2-10). Default 3. Higher slide counts cost more credits (1 per slide).
platformstring
Target platform. Default "instagram_story" (9:16). Drives aspect ratio of each slide.
Values: instagram_portrait, instagram_story, linkedin, facebook_feed, tiktok_story
useBrandboolean
Apply workspace brand kit (colors, fonts, logo, tone). Default true.

vibiz_generate_ugc

Generate a UGC-style VIDEO (motion + optional sound) via Sora. This is a single rendered video clip, NOT a sequence of images.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
productNamestringrequired
Short product / brand / service name the video is about (e.g. "Vibiz", "Acme Coffee Subscription"). Required.
productDetailsstringrequired
Paragraph describing the product, target audience, hooks, differentiators, and any tone/style notes. Required. Do NOT send a storyboard — describe the product + why it matters; the task writes its own script.
videoStylestring
Video style. "talking_head" is the default UGC phone-shot look. Other values pass through as hints.
platformstring
Target short-form platform. Drives aspect ratio + pacing. Default "tiktok".
Values: tiktok, reels, shorts
durationstring
Video length. Default "8s".
Values: 4s, 8s, 12s, 16s, 20s
creatorGenderstring
Presented gender of the AI creator / talking head. Default "female".
Values: female, male
captionsboolean
Burn captions onto the video via ZapCap. Default true.
captionStylestring
Caption look. Default "tiktok".
Values: tiktok, bold, clean, minimal
hookstring
Optional opening hook line (max 200 chars). If omitted, the task generates one from productDetails.
referenceImageUrlstring
Optional reference image URL (the "creator" face / look). Switches to image-to-video mode when provided.

vibiz_generate_ad_video

Generate a polished marketing VIDEO AD — generates a branded image THEN animates it into a short motion ad (Veo 3.1). Output lands in the creatives gallery as a video ad.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
Describe the full ad as ONE scene: subject, setting, brand framing, movement, on-screen copy. Do NOT provide frame-by-frame storyboards.
platformstring
Target platform. Mapped to a video aspect ratio server-side (9:16 for story platforms, 16:9 otherwise). Default: "facebook_feed".
Values: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic
videoDurationstring
Video length. Default "4s".
Values: 4s, 6s, 8s
videoResolutionstring
Default "720p".
Values: 720p, 1080p
generateAudioboolean
Default true.
useBrandboolean
Apply workspace brand kit. Default true.
referenceImagesarray
Optional reference images. [0] is the primary reference, the rest are additional inputs.

vibiz_generate_funnel

Generate a marketing funnel / landing page AND automatically deploy it as a live website on Vercel. End-to-end: writes the HTML/content, provisions the repo, deploys — one call.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
Describe the landing page: what it sells, the hero message, the primary CTA, target audience, tone. The generator writes its own copy — you just describe the goal. Max 500 chars stored.
qualificationboolean
Optional. Set true to build a lead-qualification funnel (multi-step questionnaire + paywall/gating) instead of a single landing page. Default: false.
creativeIdstring
Optional campaign_ad id to use as the hero image/reference for the page.
creativeImageUrlstring
Optional image URL to embed as the hero visual (alternative to creativeId).

vibiz_generate_qualification_funnel

Rewrite an EXISTING landing page into a lead-qualification funnel (multi-step form / paywall / gating flow) and auto-deploy the new version.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
funnelIdstringrequired
Id of the existing funnel to rewrite. Fetch from the user's workspace (recent funnel) or ask them to build one first via `vibiz_generate_funnel`.
promptstringrequired
Describe the qualification/gating flow: what fields to collect, what the paywall gates, what questions to ask, where the CTA leads. The generator writes its own HTML — describe the goal.

vibiz_generate_icps

Create a single Ideal Customer Profile (ICP / persona) in a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
namestringrequired
Short persona name (e.g. "SaaS Founder", "Busy Parent", "Gen-Z Gamer"). Required.
titlestring
Optional job title / role label that appears under the name (e.g. "Marketing Manager at a 50-person B2B SaaS").
descriptionstring
Optional one-paragraph summary of who they are, what motivates them, and how the brand fits into their life.
demographicsobject
Optional demographic block. All fields free-form strings.
painPointsarray
Optional list of pain points / frustrations.
goalsarray
Optional list of goals / desired outcomes.
channelsarray
Optional list of channels where this persona spends time (e.g. "TikTok", "LinkedIn", "Reddit r/SaaS").

vibiz_generate_offers

Create a single marketing OFFER (lead magnet, promotion, deal) in a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
titlestringrequired
Short, punchy offer name (max ~100 chars). E.g. "50% off everything", "Free 14-day trial", "$99 starter package".
descriptionstring
Optional details about the offer — terms, what is included, value prop. Max ~500 chars.
priceCentsinteger
Price in cents (e.g. 9900 = $99.00). Omit for free offers / lead magnets.
priceCurrencystring
ISO currency code. Default "USD".
typestring
Business model type. Default "generic" if unsure.
Values: software, service, ecommerce, agency, generic
iconEmojistring
Single emoji that represents the offer visually. E.g. "🎁", "💰", "🚀".

Analytics

Surface engagement, top-performing content, and reporting.

vibiz_analytics_top_posts

Get top-performing social media posts ranked by engagement metrics.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter by platform (facebook, instagram, linkedin, tiktok, etc.). Omit for all.
sortBystring
Metric to sort by. Default: engagement.
Values: engagement, impressions, reach, likes, comments, shares, date
fromDatestring
Start date (YYYY-MM-DD). Default: 90 days ago.
toDatestring
End date (YYYY-MM-DD). Default: today.
limitnumber
Max posts to return (1-100, default 10).

vibiz_analytics_daily_metrics

Get aggregated daily social media metrics with per-platform breakdown.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter to one platform. Omit for cross-platform aggregate.
fromDatestring
Start date (YYYY-MM-DD). Default: 30 days ago.
toDatestring
End date (YYYY-MM-DD). Default: today.

vibiz_analytics_best_time

Find the best times to post on social media based on historical engagement data.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Platform to analyze. Omit for all platforms.

Inbox

Read and reply to social-media inbox conversations.

vibiz_inbox_conversations

List recent DM conversations across the social accounts connected to a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter by platform (instagram, facebook, twitter, etc.).
limitnumber
Max conversations to return (1-50, default 10).

vibiz_inbox_comments

List posts that have received comments across the social accounts connected to a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter by platform.
sortBystring
Sort by date or comment count.
Values: date, comments
limitnumber
Max posts to return (1-50, default 10).

vibiz_inbox_reply_comment

Reply to a comment on a social media post in a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
postIdstringrequired
The post containing the comment.
commentIdstringrequired
The comment to reply to.
accountIdstringrequired
The social account to reply from. Must belong to the target vibiz.
messagestringrequired
Reply message text.

vibiz_inbox_send_dm

Send a direct message in an existing conversation on a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
conversationIdstringrequired
The conversation to send in.
accountIdstringrequired
The social account to send from. Must belong to the target vibiz.
messagestringrequired
Message text.

Social

Schedule and publish posts across connected social accounts.

vibiz_social_list_accounts

List connected social media accounts for a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

vibiz_social_list_posts

List social media posts for a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
statusstring
Filter by status.
Values: draft, scheduled, published, failed
platformstring
Filter by platform.
limitnumber
Max posts (1-100, default 10).

vibiz_social_publish

Publish or schedule a social media post to one or more platforms.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
contentstringrequired
Post text.
platformsarrayrequired
Platforms + account IDs.
mediaUrlsarray
Media URLs to attach.
scheduledForstring
ISO datetime to schedule. Omit for immediate.
hashtagsarray
Hashtags.

Meta ads

Read, launch, and manage Meta ad campaigns and creatives.

vibiz_meta_ads_campaigns_list

List Meta (Facebook + Instagram) ad campaigns connected to a vibiz via Zernio.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Values: facebook, instagram
statusstring
Values: active, paused, pending_review, rejected, completed, cancelled, error
limitinteger
Max campaigns to return (default 20).

vibiz_meta_ads_campaigns_get_tree

Return the full Campaign → Ad Set → Ad hierarchy with rolled-up metrics at every level.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Values: facebook, instagram
statusstring
Values: active, paused, pending_review, rejected, completed, cancelled, error
fromDatestring
toDatestring
limitinteger

vibiz_meta_ads_campaigns_set_status

Pause or resume a Meta ad campaign. Status transitions only — does NOT delete or duplicate.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
campaignIdstringrequired
EXPECTS: Meta platform campaign id (16-18 digit numeric, e.g. "23859876543210000"). Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`. NOT a Zernio Mongo ObjectId; NOT a Vibiz campaign UUID.
statusstringrequired
Values: active, paused
platformstringrequired
Values: facebook, instagram

vibiz_meta_ads_campaigns_bulk_set_status

Pause or resume up to 50 Meta campaigns in a single call. Per-campaign result; one bad row does not fail the batch.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
statusstringrequired
Values: active, paused
campaignsarrayrequired

vibiz_meta_ads_campaigns_duplicate

Duplicate a Meta campaign (deep copy of all ad sets + ads). The copy starts PAUSED by default.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
campaignIdstringrequired
EXPECTS: Meta platform campaign id (16-18 digit numeric). Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
platformstringrequired
Values: facebook, instagram
deepCopyboolean
Default true.
statusOptionstring
Default `PAUSED`.
Values: ACTIVE, PAUSED, INHERITED_FROM_SOURCE
startTimestring
endTimestring
renameStrategystring
Values: DEEP_RENAME, ONLY_TOP_LEVEL_RENAME, NO_RENAME
renamePrefixstring
renameSuffixstring
syncAfterboolean
Default true.

vibiz_meta_ads_campaigns_delete

Delete a Meta campaign — cascades to ad sets + ads on the platform; locally marks Ad rows as `cancelled` (preserves history).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
campaignIdstringrequired
EXPECTS: Meta platform campaign id (16-18 digit numeric). Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
platformstringrequired
Values: facebook, instagram

vibiz_meta_ads_creatives_list

List individual Meta ads (the leaf level — below campaigns and ad sets) with metrics.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Values: facebook, instagram
statusstring
Values: active, paused, pending_review, rejected, completed, cancelled, error
campaignIdstring
EXPECTS: Meta platform campaign id (16-18 digit numeric, e.g. "23859876543210000"). NOT a Zernio campaign id. Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
fromDatestring
YYYY-MM-DD
toDatestring
YYYY-MM-DD
limitinteger

vibiz_meta_ads_creatives_get

Get details of a single ad by its Zernio ad id.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.

vibiz_meta_ads_creatives_get_analytics

Get analytics for a single ad — summary + daily time series + optional Meta breakdowns (age, gender, country, etc.).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.
fromDatestring
YYYY-MM-DD
toDatestring
YYYY-MM-DD
breakdownsarray
Optional dimension keys (Meta: age | gender | country | publisher_platform | device_platform | region). Joined into a comma-separated 'breakdowns' query parameter server-side.

vibiz_meta_ads_creatives_set_status

Pause or resume a single Meta ad creative.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.
statusstringrequired
Values: active, paused

vibiz_meta_ads_creatives_delete

Cancel a single ad creative. Marks the platform ad as cancelled and updates the local row to `cancelled` (preserves history).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.

vibiz_meta_ads_launch_boost_post

Boost an existing organic Facebook or Instagram post as a paid ad. Cheaper than creating from scratch — reuses the post creative.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
postIdstring
EXPECTS: Zernio post id (24-char hex Mongo ObjectId, e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). Get it from `vibiz_social_publish` response or `vibiz_social_list_posts[].id`. Provide ONE of `postId` or `platformPostId`.
platformPostIdstring
EXPECTS: Meta platform post id (e.g. Instagram media id "12345_67890" or Facebook "123_456"). Get it from `vibiz_social_publish` response.platforms[].platformPostId or by polling the post once Late has published it. Provide ONE of `postId` or `platformPostId`.
accountIdstringrequired
EXPECTS: Zernio social account id (24-char hex Mongo ObjectId) of the post owner. Get it from `vibiz_social_list_accounts[].id`. NOT the Meta ad account `act_…`.
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_", e.g. "act_1234567890"). Get it from `vibiz_meta_ads_accounts_list[].id` for the chosen socialAccountId. NOT a Zernio Mongo ObjectId.
namestringrequired
Ad name (max 255 chars).
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetobjectrequired
currencystring
ISO-4217 currency code.
scheduleobject
targetingobject
bidAmountnumber
Meta only.
trackingobject
Meta only.
specialAdCategoriesarray
Meta only.

vibiz_meta_ads_launch_create

Create a standalone Meta ad from scratch — campaign + ad set + ad in one call. No existing post needed.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
accountIdstringrequired
EXPECTS: Zernio social account id (24-char hex Mongo ObjectId). Get it from `vibiz_social_list_accounts[].id`. NOT a Meta `act_…` id.
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`.
namestringrequired
Ad name (max 255 chars).
goalstring
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetAmountnumber
budgetTypestring
Values: daily, lifetime
currencystring
headlinestring
bodystring
callToActionstring
Meta only.
Values: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE
linkUrlstring
imageUrlstring
videoobject
Meta only.
adSetIdstring
Meta only — attach this creative to an existing ad set. Mutually exclusive with `creatives[]`.
countriesarray
ageMininteger
ageMaxinteger
interestsarray
endDatestring
Required for lifetime budgets.
audienceIdstring
advantageAudienceinteger
Values: 0, 1

vibiz_meta_ads_accounts_list

List the platform ad accounts (e.g. Meta `act_…` ids) reachable through a given Zernio social account.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
socialAccountIdstringrequired
EXPECTS: Zernio social account id (24-char hex Mongo ObjectId). Get it from `vibiz_social_list_accounts[].id`. NOT a Meta platform ad account `act_…` id — that comes back from THIS tool as `accounts[].id`.

vibiz_meta_ads_accounts_get_connect_url

Start the ads-specific OAuth flow for a platform. Returns either an `authUrl` to send the user to, or `{ alreadyConnected: true }` when the workspace already has an ads credential for that platform.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringrequired
Ads platform to connect. Note `googleads` (not `google`).
Values: facebook, instagram, linkedin, tiktok, twitter, pinterest, googleads
socialAccountIdstring
Required for separate-token platforms (tiktok, twitter); ignored for same-token + standalone.
redirectUrlstring
Custom URL to redirect the user back to after OAuth (same-token platforms only).

Reference

Tool reference

33 tools across 5 surfaces. Each entry shows the tool name, what it does, and its input parameters as exposed via tools/list.

Generation

Create images, videos, funnels, and creative insights.

vibiz_generate_image

Generate ONE static ad IMAGE (no motion, no sound).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
Describe the STATIC IMAGE to generate. Do not structure as storyboard/frames.
platformstring
Target platform. MUST be one of the listed values. Common mappings: TikTok → "tiktok_story", Instagram feed → "instagram_portrait", Instagram story → "instagram_story", Facebook → "facebook_feed", LinkedIn → "linkedin". Default: "instagram_portrait".
Values: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic
aspectRatiostring
Optional. If omitted, derived from `platform`. 9:16 = vertical, 1:1 = square, 16:9 = landscape.
Values: 1:1, 16:9, 9:16, 4:5, 3:2
stylestring
Per-app style key. "branded-ad" is the default marketing ad style.
Values: branded-ad, shots, hyperrealistic, infographic, ecommerce-product
useBrandboolean
Apply the workspace brand kit (colors, fonts, logo, tone). Default true. Set false only if the user explicitly wants a generic look.
imageCountinteger
Number of VARIATIONS of the SAME image to generate (1-4). Default 1. NOT for making a video storyboard — use `vibiz_generate_ugc` for motion content.

vibiz_generate_carousel

Generate a multi-slide marketing CAROUSEL (hook → story → CTA) for Instagram, LinkedIn, or similar slide-based placements. Each slide is its own image; they ship as one cohesive set.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
What the carousel is about: topic, angle, key message. The generator writes per-slide copy — you describe the story, not the individual slides.
slideCountinteger
Number of slides (2-10). Default 3. Higher slide counts cost more credits (1 per slide).
platformstring
Target platform. Default "instagram_story" (9:16). Drives aspect ratio of each slide.
Values: instagram_portrait, instagram_story, linkedin, facebook_feed, tiktok_story
useBrandboolean
Apply workspace brand kit (colors, fonts, logo, tone). Default true.

vibiz_generate_ugc

Generate a UGC-style VIDEO (motion + optional sound) via Sora. This is a single rendered video clip, NOT a sequence of images.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
productNamestringrequired
Short product / brand / service name the video is about (e.g. "Vibiz", "Acme Coffee Subscription"). Required.
productDetailsstringrequired
Paragraph describing the product, target audience, hooks, differentiators, and any tone/style notes. Required. Do NOT send a storyboard — describe the product + why it matters; the task writes its own script.
videoStylestring
Video style. "talking_head" is the default UGC phone-shot look. Other values pass through as hints.
platformstring
Target short-form platform. Drives aspect ratio + pacing. Default "tiktok".
Values: tiktok, reels, shorts
durationstring
Video length. Default "8s".
Values: 4s, 8s, 12s, 16s, 20s
creatorGenderstring
Presented gender of the AI creator / talking head. Default "female".
Values: female, male
captionsboolean
Burn captions onto the video via ZapCap. Default true.
captionStylestring
Caption look. Default "tiktok".
Values: tiktok, bold, clean, minimal
hookstring
Optional opening hook line (max 200 chars). If omitted, the task generates one from productDetails.
referenceImageUrlstring
Optional reference image URL (the "creator" face / look). Switches to image-to-video mode when provided.

vibiz_generate_ad_video

Generate a polished marketing VIDEO AD — generates a branded image THEN animates it into a short motion ad (Veo 3.1). Output lands in the creatives gallery as a video ad.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
Describe the full ad as ONE scene: subject, setting, brand framing, movement, on-screen copy. Do NOT provide frame-by-frame storyboards.
platformstring
Target platform. Mapped to a video aspect ratio server-side (9:16 for story platforms, 16:9 otherwise). Default: "facebook_feed".
Values: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic
videoDurationstring
Video length. Default "4s".
Values: 4s, 6s, 8s
videoResolutionstring
Default "720p".
Values: 720p, 1080p
generateAudioboolean
Default true.
useBrandboolean
Apply workspace brand kit. Default true.
referenceImagesarray
Optional reference images. [0] is the primary reference, the rest are additional inputs.

vibiz_generate_funnel

Generate a marketing funnel / landing page AND automatically deploy it as a live website on Vercel. End-to-end: writes the HTML/content, provisions the repo, deploys — one call.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
promptstringrequired
Describe the landing page: what it sells, the hero message, the primary CTA, target audience, tone. The generator writes its own copy — you just describe the goal. Max 500 chars stored.
qualificationboolean
Optional. Set true to build a lead-qualification funnel (multi-step questionnaire + paywall/gating) instead of a single landing page. Default: false.
creativeIdstring
Optional campaign_ad id to use as the hero image/reference for the page.
creativeImageUrlstring
Optional image URL to embed as the hero visual (alternative to creativeId).

vibiz_generate_qualification_funnel

Rewrite an EXISTING landing page into a lead-qualification funnel (multi-step form / paywall / gating flow) and auto-deploy the new version.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
funnelIdstringrequired
Id of the existing funnel to rewrite. Fetch from the user's workspace (recent funnel) or ask them to build one first via `vibiz_generate_funnel`.
promptstringrequired
Describe the qualification/gating flow: what fields to collect, what the paywall gates, what questions to ask, where the CTA leads. The generator writes its own HTML — describe the goal.

vibiz_generate_icps

Create a single Ideal Customer Profile (ICP / persona) in a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
namestringrequired
Short persona name (e.g. "SaaS Founder", "Busy Parent", "Gen-Z Gamer"). Required.
titlestring
Optional job title / role label that appears under the name (e.g. "Marketing Manager at a 50-person B2B SaaS").
descriptionstring
Optional one-paragraph summary of who they are, what motivates them, and how the brand fits into their life.
demographicsobject
Optional demographic block. All fields free-form strings.
painPointsarray
Optional list of pain points / frustrations.
goalsarray
Optional list of goals / desired outcomes.
channelsarray
Optional list of channels where this persona spends time (e.g. "TikTok", "LinkedIn", "Reddit r/SaaS").

vibiz_generate_offers

Create a single marketing OFFER (lead magnet, promotion, deal) in a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
titlestringrequired
Short, punchy offer name (max ~100 chars). E.g. "50% off everything", "Free 14-day trial", "$99 starter package".
descriptionstring
Optional details about the offer — terms, what is included, value prop. Max ~500 chars.
priceCentsinteger
Price in cents (e.g. 9900 = $99.00). Omit for free offers / lead magnets.
priceCurrencystring
ISO currency code. Default "USD".
typestring
Business model type. Default "generic" if unsure.
Values: software, service, ecommerce, agency, generic
iconEmojistring
Single emoji that represents the offer visually. E.g. "🎁", "💰", "🚀".

Analytics

Surface engagement, top-performing content, and reporting.

vibiz_analytics_top_posts

Get top-performing social media posts ranked by engagement metrics.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter by platform (facebook, instagram, linkedin, tiktok, etc.). Omit for all.
sortBystring
Metric to sort by. Default: engagement.
Values: engagement, impressions, reach, likes, comments, shares, date
fromDatestring
Start date (YYYY-MM-DD). Default: 90 days ago.
toDatestring
End date (YYYY-MM-DD). Default: today.
limitnumber
Max posts to return (1-100, default 10).

vibiz_analytics_daily_metrics

Get aggregated daily social media metrics with per-platform breakdown.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter to one platform. Omit for cross-platform aggregate.
fromDatestring
Start date (YYYY-MM-DD). Default: 30 days ago.
toDatestring
End date (YYYY-MM-DD). Default: today.

vibiz_analytics_best_time

Find the best times to post on social media based on historical engagement data.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Platform to analyze. Omit for all platforms.

Inbox

Read and reply to social-media inbox conversations.

vibiz_inbox_conversations

List recent DM conversations across the social accounts connected to a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter by platform (instagram, facebook, twitter, etc.).
limitnumber
Max conversations to return (1-50, default 10).

vibiz_inbox_comments

List posts that have received comments across the social accounts connected to a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Filter by platform.
sortBystring
Sort by date or comment count.
Values: date, comments
limitnumber
Max posts to return (1-50, default 10).

vibiz_inbox_reply_comment

Reply to a comment on a social media post in a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
postIdstringrequired
The post containing the comment.
commentIdstringrequired
The comment to reply to.
accountIdstringrequired
The social account to reply from. Must belong to the target vibiz.
messagestringrequired
Reply message text.

vibiz_inbox_send_dm

Send a direct message in an existing conversation on a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
conversationIdstringrequired
The conversation to send in.
accountIdstringrequired
The social account to send from. Must belong to the target vibiz.
messagestringrequired
Message text.

Social

Schedule and publish posts across connected social accounts.

vibiz_social_list_accounts

List connected social media accounts for a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

vibiz_social_list_posts

List social media posts for a vibiz.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
statusstring
Filter by status.
Values: draft, scheduled, published, failed
platformstring
Filter by platform.
limitnumber
Max posts (1-100, default 10).

vibiz_social_publish

Publish or schedule a social media post to one or more platforms.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
contentstringrequired
Post text.
platformsarrayrequired
Platforms + account IDs.
mediaUrlsarray
Media URLs to attach.
scheduledForstring
ISO datetime to schedule. Omit for immediate.
hashtagsarray
Hashtags.

Meta ads

Read, launch, and manage Meta ad campaigns and creatives.

vibiz_meta_ads_campaigns_list

List Meta (Facebook + Instagram) ad campaigns connected to a vibiz via Zernio.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Values: facebook, instagram
statusstring
Values: active, paused, pending_review, rejected, completed, cancelled, error
limitinteger
Max campaigns to return (default 20).

vibiz_meta_ads_campaigns_get_tree

Return the full Campaign → Ad Set → Ad hierarchy with rolled-up metrics at every level.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Values: facebook, instagram
statusstring
Values: active, paused, pending_review, rejected, completed, cancelled, error
fromDatestring
toDatestring
limitinteger

vibiz_meta_ads_campaigns_set_status

Pause or resume a Meta ad campaign. Status transitions only — does NOT delete or duplicate.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
campaignIdstringrequired
EXPECTS: Meta platform campaign id (16-18 digit numeric, e.g. "23859876543210000"). Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`. NOT a Zernio Mongo ObjectId; NOT a Vibiz campaign UUID.
statusstringrequired
Values: active, paused
platformstringrequired
Values: facebook, instagram

vibiz_meta_ads_campaigns_bulk_set_status

Pause or resume up to 50 Meta campaigns in a single call. Per-campaign result; one bad row does not fail the batch.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
statusstringrequired
Values: active, paused
campaignsarrayrequired

vibiz_meta_ads_campaigns_duplicate

Duplicate a Meta campaign (deep copy of all ad sets + ads). The copy starts PAUSED by default.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
campaignIdstringrequired
EXPECTS: Meta platform campaign id (16-18 digit numeric). Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
platformstringrequired
Values: facebook, instagram
deepCopyboolean
Default true.
statusOptionstring
Default `PAUSED`.
Values: ACTIVE, PAUSED, INHERITED_FROM_SOURCE
startTimestring
endTimestring
renameStrategystring
Values: DEEP_RENAME, ONLY_TOP_LEVEL_RENAME, NO_RENAME
renamePrefixstring
renameSuffixstring
syncAfterboolean
Default true.

vibiz_meta_ads_campaigns_delete

Delete a Meta campaign — cascades to ad sets + ads on the platform; locally marks Ad rows as `cancelled` (preserves history).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
campaignIdstringrequired
EXPECTS: Meta platform campaign id (16-18 digit numeric). Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
platformstringrequired
Values: facebook, instagram

vibiz_meta_ads_creatives_list

List individual Meta ads (the leaf level — below campaigns and ad sets) with metrics.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstring
Values: facebook, instagram
statusstring
Values: active, paused, pending_review, rejected, completed, cancelled, error
campaignIdstring
EXPECTS: Meta platform campaign id (16-18 digit numeric, e.g. "23859876543210000"). NOT a Zernio campaign id. Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
fromDatestring
YYYY-MM-DD
toDatestring
YYYY-MM-DD
limitinteger

vibiz_meta_ads_creatives_get

Get details of a single ad by its Zernio ad id.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.

vibiz_meta_ads_creatives_get_analytics

Get analytics for a single ad — summary + daily time series + optional Meta breakdowns (age, gender, country, etc.).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.
fromDatestring
YYYY-MM-DD
toDatestring
YYYY-MM-DD
breakdownsarray
Optional dimension keys (Meta: age | gender | country | publisher_platform | device_platform | region). Joined into a comma-separated 'breakdowns' query parameter server-side.

vibiz_meta_ads_creatives_set_status

Pause or resume a single Meta ad creative.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.
statusstringrequired
Values: active, paused

vibiz_meta_ads_creatives_delete

Cancel a single ad creative. Marks the platform ad as cancelled and updates the local row to `cancelled` (preserves history).

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Zernio ad id — a 24-char hex Mongo ObjectId (e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). You get this from `vibiz_meta_ads_creatives_list[].id`. NOT the Meta platform numeric id, NOT a Vibiz campaign_ad UUID.

vibiz_meta_ads_launch_boost_post

Boost an existing organic Facebook or Instagram post as a paid ad. Cheaper than creating from scratch — reuses the post creative.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
postIdstring
EXPECTS: Zernio post id (24-char hex Mongo ObjectId, e.g. "65a3f0c1d2e4b8e9f4a1c2d3"). Get it from `vibiz_social_publish` response or `vibiz_social_list_posts[].id`. Provide ONE of `postId` or `platformPostId`.
platformPostIdstring
EXPECTS: Meta platform post id (e.g. Instagram media id "12345_67890" or Facebook "123_456"). Get it from `vibiz_social_publish` response.platforms[].platformPostId or by polling the post once Late has published it. Provide ONE of `postId` or `platformPostId`.
accountIdstringrequired
EXPECTS: Zernio social account id (24-char hex Mongo ObjectId) of the post owner. Get it from `vibiz_social_list_accounts[].id`. NOT the Meta ad account `act_…`.
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_", e.g. "act_1234567890"). Get it from `vibiz_meta_ads_accounts_list[].id` for the chosen socialAccountId. NOT a Zernio Mongo ObjectId.
namestringrequired
Ad name (max 255 chars).
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetobjectrequired
currencystring
ISO-4217 currency code.
scheduleobject
targetingobject
bidAmountnumber
Meta only.
trackingobject
Meta only.
specialAdCategoriesarray
Meta only.

vibiz_meta_ads_launch_create

Create a standalone Meta ad from scratch — campaign + ad set + ad in one call. No existing post needed.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
accountIdstringrequired
EXPECTS: Zernio social account id (24-char hex Mongo ObjectId). Get it from `vibiz_social_list_accounts[].id`. NOT a Meta `act_…` id.
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`.
namestringrequired
Ad name (max 255 chars).
goalstring
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetAmountnumber
budgetTypestring
Values: daily, lifetime
currencystring
headlinestring
bodystring
callToActionstring
Meta only.
Values: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE
linkUrlstring
imageUrlstring
videoobject
Meta only.
adSetIdstring
Meta only — attach this creative to an existing ad set. Mutually exclusive with `creatives[]`.
countriesarray
ageMininteger
ageMaxinteger
interestsarray
endDatestring
Required for lifetime budgets.
audienceIdstring
advantageAudienceinteger
Values: 0, 1

vibiz_meta_ads_accounts_list

List the platform ad accounts (e.g. Meta `act_…` ids) reachable through a given Zernio social account.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
socialAccountIdstringrequired
EXPECTS: Zernio social account id (24-char hex Mongo ObjectId). Get it from `vibiz_social_list_accounts[].id`. NOT a Meta platform ad account `act_…` id — that comes back from THIS tool as `accounts[].id`.

vibiz_meta_ads_accounts_get_connect_url

Start the ads-specific OAuth flow for a platform. Returns either an `authUrl` to send the user to, or `{ alreadyConnected: true }` when the workspace already has an ads credential for that platform.

Parameters

targetobject
Where the generation should be applied. Pass `vibiz` (slug from list_vibiz) OR `brandUrl` (any URL — we scrape its brand). CRITICAL: if the user requests a brand that is not in the list_vibiz output AND brandUrl is not yet supported (or the URL fails), DO NOT silently fall back to a different vibiz. Tell the user the brand is not yet onboarded and either (a) suggest they create a new vibiz at /create or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringrequired
Ads platform to connect. Note `googleads` (not `google`).
Values: facebook, instagram, linkedin, tiktok, twitter, pinterest, googleads
socialAccountIdstring
Required for separate-token platforms (tiktok, twitter); ignored for same-token + standalone.
redirectUrlstring
Custom URL to redirect the user back to after OAuth (same-token platforms only).