Reference

Tool reference

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

Generation

8 tools

Create images, videos, funnels, and creative insights.

vibiz_generate_image

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

Parameters

targetobjectoptional
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 /new-vibiz 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.
platformstringoptional
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
aspectRatiostringoptional
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
stylestringoptional
Per-category style key. "hero-shot" is the default product-first studio hero; pick lifestyle-shot for planned real-world product context, ugc for social-native creator/phone-camera product shots, hyperrealistic for cinematic photographic realism, saas-demo for product UI, founder-portrait for trust-building, infographic for diagrams.
Values: hero-shot, lifestyle-shot, ugc, hyperrealistic, saas-demo, founder-portrait, infographic
useBrandbooleanoptional
Apply the workspace brand kit (colors, fonts, logo, tone). Default true. Set false only if the user explicitly wants a generic look.
imageCountintegeroptional
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.
offerIdstringoptional
Offer/product id this generation is for. Get it from `vibiz_list_offers[].id`. When set, the prompt builder grounds the image to that product (title, price, image, source URL). REQUIRED when the user said 'my product' / 'this offer' — call `vibiz_list_offers` first and pass the matching id. If the workspace has multiple offers and the user didn't disambiguate, ASK them which one before calling this tool.
lightingstringoptional
Per-call lighting override. Default 'auto' (uses workspace-level setting). Map user prose: 'dramatic' → dramatic, 'golden-hour glow' → golden-hour, 'softbox' → studio, 'outdoor daylight' → natural.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Map: 'corporate' → professional, 'fun/quirky' → playful, 'luxury' → premium, 'clean/whitespace' → minimal, 'cozy/inviting' → warm.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override. Map: 'looking up' → low-angle, 'top-down/flat-lay' → aerial, 'macro/detail' → close-up.
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
How loudly the workspace brand kit asserts itself. 'subtle' for editorial / lifestyle, 'strong' for direct-response ads with prominent logo + colors.
Values: auto, subtle, standard, strong
logoModestringoptional
Whether to stamp the workspace logo on the output. 'off' for editorial / lifestyle shots, 'on' for packaging / brand-marked ads.
Values: auto, on, off
compositionstringoptional
Layout. 'flat-lay' for top-down product collages, 'rule-of-thirds' for editorial / social, 'centered' for hero shots.
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
slideCountintegeroptional
Number of slides (2-10). Default 3. Higher slide counts cost more credits (1 per slide).
platformstringoptional
Target platform. Default "instagram_story" (9:16). Drives aspect ratio of each slide.
Values: instagram_portrait, instagram_story, linkedin, facebook_feed, tiktok_story
useBrandbooleanoptional
Apply workspace brand kit (colors, fonts, logo, tone). Default true.
offerIdstringoptional
Offer/product id this carousel is about. Get it from `vibiz_list_offers[].id`. When set, slide copy + visuals are grounded to that product. REQUIRED when the user said 'my product' / 'a carousel about [thing I sell]' — call `vibiz_list_offers` first and ASK if multiple offers could match.
lightingstringoptional
Per-call lighting override. Default 'auto'. Map user prose like 'dramatic', 'golden-hour', 'studio'.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Map: 'corporate' → professional, 'luxury' → premium, 'clean' → minimal.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override.
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
How loudly the workspace brand kit asserts itself.
Values: auto, subtle, standard, strong
logoModestringoptional
Whether to stamp the workspace logo on each slide.
Values: auto, on, off
compositionstringoptional
Layout for slide visuals.
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
videoStylestringoptional
Video style. talking_head is the default face-led phone-shot look; review, unboxing, and pov now change the visual Sora brief as well as the script.
Values: talking_head, review, unboxing, pov
platformstringoptional
Target short-form platform. Drives aspect ratio + pacing. Default "tiktok".
Values: tiktok, reels, shorts
durationstringoptional
Video length. Default "8s".
Values: 4s, 8s, 12s, 16s, 20s
creatorGenderstringoptional
Presented gender of the AI creator / talking head. Default "female".
Values: female, male
captionsbooleanoptional
Burn captions onto the video via ZapCap. Default true.
captionStylestringoptional
Caption look. Default "tiktok".
Values: tiktok, bold, clean, minimal
hookstringoptional
Optional opening hook line (max 200 chars). If omitted, the task generates one from productDetails.
referenceImageUrlstringoptional
Optional reference image URL (the "creator" face / look). Switches to image-to-video mode when provided.
offerIdstringoptional
Offer/product id this UGC clip is for. Get it from `vibiz_list_offers[].id`. When set, the chat agent's chosen offer is recorded on the resulting ad row so downstream tooling can reuse it. REQUIRED when the user said 'a UGC about my product' / 'spokesperson video for [thing I sell]' — call `vibiz_list_offers` first and ASK if multiple plausible offers exist.
icpIdstringoptional
Optional selected ICP/customer profile id. Use when the user names a target audience or when an offer has a clear linked ICP; it shapes the UGC hook and creator angle.
personaIdstringoptional
Optional persona id within the selected ICP. Use only when the user explicitly selects a persona.
lightingstringoptional
Per-call lighting override. Default 'auto'. Today the Sora UGC pipeline does not yet style on this — value is recorded on the ad for future pipelines + observability.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Today not yet wired into the Sora script; recorded on the ad row.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override (observable on ad row).
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
Brand kit assertiveness (observable on ad row).
Values: auto, subtle, standard, strong
logoModestringoptional
Logo stamping intent (observable on ad row).
Values: auto, on, off
compositionstringoptional
Composition intent (observable on ad row).
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
platformstringoptional
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
videoDurationstringoptional
Video length. Default "4s".
Values: 4s, 6s, 8s
videoResolutionstringoptional
Default "720p".
Values: 720p, 1080p
generateAudiobooleanoptional
Default true.
useBrandbooleanoptional
Apply workspace brand kit. Default true.
referenceImagesarrayoptional
Optional reference images. [0] is the primary reference, the rest are additional inputs.
offerIdstringoptional
Offer/product id this video is for. Get it from `vibiz_list_offers[].id`. When set, the underlying image (phase 1) is grounded to the product's title/price/image. REQUIRED when the user said 'a video ad for my product' / 'video for this offer' — call `vibiz_list_offers` first and ASK if multiple plausible offers exist.
lightingstringoptional
Per-call lighting override (applies to the image phase). Default 'auto'. Map user prose: 'dramatic' → dramatic, 'golden-hour' → golden-hour, 'softbox' → studio.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Map: 'corporate' → professional, 'luxury' → premium, 'clean' → minimal.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override.
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
How loudly the workspace brand kit asserts itself.
Values: auto, subtle, standard, strong
logoModestringoptional
Whether to stamp the workspace logo on the image phase.
Values: auto, on, off
compositionstringoptional
Layout for the underlying image phase.
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
qualificationbooleanoptional
Optional. Set true to build a lead-qualification funnel (multi-step questionnaire + paywall/gating) instead of a single landing page. Default: false.
creativeIdstringoptional
Optional campaign_ad id to use as the hero image/reference for the page.
creativeImageUrlstringoptional
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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz 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.
titlestringoptional
Optional job title / role label that appears under the name (e.g. "Marketing Manager at a 50-person B2B SaaS").
descriptionstringoptional
Optional one-paragraph summary of who they are, what motivates them, and how the brand fits into their life.
demographicsobjectoptional
Optional demographic block. All fields free-form strings.
painPointsarrayoptional
Optional list of pain points / frustrations.
goalsarrayoptional
Optional list of goals / desired outcomes.
channelsarrayoptional
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

targetobjectoptional
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 /new-vibiz 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".
descriptionstringoptional
Optional details about the offer — terms, what is included, value prop. Max ~500 chars.
priceCentsintegeroptional
Price in cents (e.g. 9900 = $99.00). Omit for free offers / lead magnets.
priceCurrencystringoptional
ISO currency code. Default "USD".
typestringoptional
Business model type. Default "generic" if unsure.
Values: software, service, ecommerce, agency, generic
iconEmojistringoptional
Single emoji that represents the offer visually. E.g. "🎁", "💰", "🚀".

Workspace

3 tools

Read brand context and send branded transactional emails.

vibiz_workspace_generate_icps_pipeline

Bulk-discover Ideal Customer Profiles (ICPs / personas) from the workspace branding.

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

vibiz_workspace_generate_offers_pipeline

Bulk-discover marketing offers from the workspace branding / website.

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

vibiz_workspace_generate_knowledge_pipeline

Generate the workspace's business knowledge-base summary.

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

Analytics

3 tools

Surface engagement, top-performing content, and reporting.

vibiz_analytics_top_posts

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter by platform (facebook, instagram, linkedin, tiktok, etc.). Omit for all.
sortBystringoptional
Metric to sort by. Default: engagement.
Values: engagement, impressions, reach, likes, comments, shares, date
fromDatestringoptional
Start date (YYYY-MM-DD). Default: 90 days ago.
toDatestringoptional
End date (YYYY-MM-DD). Default: today.
limitnumberoptional
Max posts to return (1-100, default 10).

vibiz_analytics_daily_metrics

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter to one platform. Omit for cross-platform aggregate.
fromDatestringoptional
Start date (YYYY-MM-DD). Default: 30 days ago.
toDatestringoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Platform to analyze. Omit for all platforms.

Inbox

4 tools

Read and reply to social-media inbox conversations.

vibiz_inbox_conversations

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter by platform (instagram, facebook, twitter, etc.).
limitnumberoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter by platform.
sortBystringoptional
Sort by date or comment count.
Values: date, comments
limitnumberoptional
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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz 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.

Meta ads

24 tools

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

vibiz_meta_ads_campaigns_list

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Values: facebook, instagram
statusstringoptional
Values: active, paused, pending_review, rejected, completed, cancelled, error
limitintegeroptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Values: facebook, instagram
statusstringoptional
Values: active, paused, pending_review, rejected, completed, cancelled, error
fromDatestringoptional
toDatestringoptional
limitintegeroptional

vibiz_meta_ads_campaigns_set_status

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

Parameters

targetobjectoptional
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 /new-vibiz 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 an internal 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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz 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
deepCopybooleanoptional
Default true.
statusOptionstringoptional
Default `PAUSED`.
Values: ACTIVE, PAUSED, INHERITED_FROM_SOURCE
startTimestringoptional
endTimestringoptional
renameStrategystringoptional
Values: DEEP_RENAME, ONLY_TOP_LEVEL_RENAME, NO_RENAME
renamePrefixstringoptional
renameSuffixstringoptional
syncAfterbooleanoptional
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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Values: facebook, instagram
statusstringoptional
Values: active, paused, pending_review, rejected, completed, cancelled, error
campaignIdstringoptional
EXPECTS: Meta platform campaign id (16-18 digit numeric, e.g. "23859876543210000"). NOT an internal campaign id. Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
fromDatestringoptional
YYYY-MM-DD
toDatestringoptional
YYYY-MM-DD
limitintegeroptional

vibiz_meta_ads_creatives_get

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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.
fromDatestringoptional
YYYY-MM-DD
toDatestringoptional
YYYY-MM-DD
breakdownsarrayoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
postIdstringoptional
EXPECTS: internal 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`.
platformPostIdstringoptional
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 it has been published on the platform. Provide ONE of `postId` or `platformPostId`.
accountIdstringrequired
EXPECTS: 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 an internal Mongo ObjectId.
namestringrequired
Ad name (max 255 chars).
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetobjectrequired
currencystringoptional
ISO-4217 currency code.
scheduleobjectoptional
targetingobjectoptional
bidAmountnumberoptional
Meta only.
trackingobjectoptional
Meta only.
specialAdCategoriesarrayoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
accountIdstringrequired
EXPECTS: 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).
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetAmountnumberrequired
Budget amount in the ad account currency. Minimums: Meta=$1/day, TikTok=$20/day, Pinterest=$5/day.
budgetTypestringrequired
Values: daily, lifetime
currencystringoptional
headlinestringoptional
bodystringoptional
callToActionstringoptional
Meta only.
Values: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE
linkUrlstringoptional
imageUrlstringoptional
videoobjectoptional
Meta only.
adSetIdstringoptional
Meta only — attach this creative to an existing ad set. Mutually exclusive with `creatives[]`.
countriesarrayoptional
ageMinintegeroptional
ageMaxintegeroptional
interestsarrayoptional
endDatestringoptional
Required for lifetime budgets.
audienceIdstringoptional
advantageAudienceintegeroptional
Advantage Audience flag. 0 = off, 1 = on. Constrained via minimum/maximum (not enum) so Gemini accepts the schema.

vibiz_meta_ads_launch_bulk

Launch multiple Meta ads in ONE call — all sharing the same campaign, ad set, budget, and targeting. Cheaper and faster than calling `vibiz_meta_ads_launch_create` N times because it avoids creating N separate campaigns.

Parameters

targetobjectoptional
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 /new-vibiz 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
Campaign name (max 255 chars). Each ad inside the campaign gets an auto-numbered name from Meta.
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetAmountnumberrequired
Shared budget for the whole ad set (NOT per-ad). Meta=$1/day minimum.
budgetTypestringrequired
Values: daily, lifetime
currencystringoptional
ISO-4217 currency code.
creativesarrayrequired
Array of ad creatives. Each entry needs exactly one of `imageUrl` or `video`. All other fields are required.
countriesarrayoptional
ageMinintegeroptional
ageMaxintegeroptional
interestsarrayoptional
endDatestringoptional
Required for lifetime budgets.
audienceIdstringoptional
advantageAudienceintegeroptional
Advantage Audience flag. 0 = off, 1 = on. Constrained via minimum/maximum (not enum) so Gemini accepts the schema.

vibiz_meta_ads_accounts_list

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
socialAccountIdstringrequired
EXPECTS: 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

targetobjectoptional
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 /new-vibiz 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
socialAccountIdstringoptional
Required for separate-token platforms (tiktok, twitter); ignored for same-token + standalone.
redirectUrlstringoptional
Custom URL to redirect the user back to after OAuth (same-token platforms only).

vibiz_meta_ads_pixels_create

Provision a new Meta Pixel under a Meta ad account. Returns the pixel id and the install snippet (`tag.code`) the user pastes into their site (or the assistant injects into a generated funnel).

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`.
namestringrequired
Human-readable pixel name shown in Meta Events Manager. Tip: include the workspace name so a user with multiple pixels can tell them apart (e.g. 'NeceSera — Main Site Pixel').

vibiz_meta_ads_pixels_list

List every Meta Pixel reachable through the given social account. Pass `adAccountId` to scope to one ad account.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
adAccountIdstringoptional
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`. OPTIONAL — omit to list pixels across every ad account on this social account.

vibiz_meta_ads_pixels_get

Fetch one Meta Pixel by id, including the install snippet (`code`) and `lastFiredTime`.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).

vibiz_meta_ads_pixels_stats

Pixel event performance broken down by an aggregation dimension (event / host / url / device_type).

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
aggregationstringoptional
Aggregation dimension. Defaults to Zernio's server-side default (event) when omitted.
Values: event, host, url, device_type

vibiz_meta_ads_pixels_update

Rename a pixel or toggle Meta's feature flags on it (Advanced Matching, first-party cookies, data-use setting).

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
namestringoptional
enableAutomaticMatchingbooleanoptional
firstPartyCookieStatusstringoptional
dataUseSettingstringoptional

vibiz_meta_ads_pixels_share

Grant another Meta ad account permission to fire / read this pixel. This is the "grant pixel on demand" handoff: a workspace can wire one pixel into ad campaigns owned by separate ad accounts without copy-pasting install snippets per surface.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`. This is the RECIPIENT ad account that should gain access — NOT the ad account the pixel was originally created on.

vibiz_meta_ads_pixels_list_shares

List the Meta ad accounts this pixel is currently shared with. Pair with `vibiz_meta_ads_pixels_share` / `_unshare` to audit and tighten permissions.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).

vibiz_meta_ads_pixels_unshare

Revoke a Meta ad account's access to this pixel. Closest thing to 'delete' since Meta does not expose a pixel-delete endpoint.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`.

Reference

Tool reference

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

Generation

8 tools

Create images, videos, funnels, and creative insights.

vibiz_generate_image

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

Parameters

targetobjectoptional
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 /new-vibiz 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.
platformstringoptional
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
aspectRatiostringoptional
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
stylestringoptional
Per-category style key. "hero-shot" is the default product-first studio hero; pick lifestyle-shot for planned real-world product context, ugc for social-native creator/phone-camera product shots, hyperrealistic for cinematic photographic realism, saas-demo for product UI, founder-portrait for trust-building, infographic for diagrams.
Values: hero-shot, lifestyle-shot, ugc, hyperrealistic, saas-demo, founder-portrait, infographic
useBrandbooleanoptional
Apply the workspace brand kit (colors, fonts, logo, tone). Default true. Set false only if the user explicitly wants a generic look.
imageCountintegeroptional
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.
offerIdstringoptional
Offer/product id this generation is for. Get it from `vibiz_list_offers[].id`. When set, the prompt builder grounds the image to that product (title, price, image, source URL). REQUIRED when the user said 'my product' / 'this offer' — call `vibiz_list_offers` first and pass the matching id. If the workspace has multiple offers and the user didn't disambiguate, ASK them which one before calling this tool.
lightingstringoptional
Per-call lighting override. Default 'auto' (uses workspace-level setting). Map user prose: 'dramatic' → dramatic, 'golden-hour glow' → golden-hour, 'softbox' → studio, 'outdoor daylight' → natural.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Map: 'corporate' → professional, 'fun/quirky' → playful, 'luxury' → premium, 'clean/whitespace' → minimal, 'cozy/inviting' → warm.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override. Map: 'looking up' → low-angle, 'top-down/flat-lay' → aerial, 'macro/detail' → close-up.
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
How loudly the workspace brand kit asserts itself. 'subtle' for editorial / lifestyle, 'strong' for direct-response ads with prominent logo + colors.
Values: auto, subtle, standard, strong
logoModestringoptional
Whether to stamp the workspace logo on the output. 'off' for editorial / lifestyle shots, 'on' for packaging / brand-marked ads.
Values: auto, on, off
compositionstringoptional
Layout. 'flat-lay' for top-down product collages, 'rule-of-thirds' for editorial / social, 'centered' for hero shots.
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
slideCountintegeroptional
Number of slides (2-10). Default 3. Higher slide counts cost more credits (1 per slide).
platformstringoptional
Target platform. Default "instagram_story" (9:16). Drives aspect ratio of each slide.
Values: instagram_portrait, instagram_story, linkedin, facebook_feed, tiktok_story
useBrandbooleanoptional
Apply workspace brand kit (colors, fonts, logo, tone). Default true.
offerIdstringoptional
Offer/product id this carousel is about. Get it from `vibiz_list_offers[].id`. When set, slide copy + visuals are grounded to that product. REQUIRED when the user said 'my product' / 'a carousel about [thing I sell]' — call `vibiz_list_offers` first and ASK if multiple offers could match.
lightingstringoptional
Per-call lighting override. Default 'auto'. Map user prose like 'dramatic', 'golden-hour', 'studio'.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Map: 'corporate' → professional, 'luxury' → premium, 'clean' → minimal.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override.
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
How loudly the workspace brand kit asserts itself.
Values: auto, subtle, standard, strong
logoModestringoptional
Whether to stamp the workspace logo on each slide.
Values: auto, on, off
compositionstringoptional
Layout for slide visuals.
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
videoStylestringoptional
Video style. talking_head is the default face-led phone-shot look; review, unboxing, and pov now change the visual Sora brief as well as the script.
Values: talking_head, review, unboxing, pov
platformstringoptional
Target short-form platform. Drives aspect ratio + pacing. Default "tiktok".
Values: tiktok, reels, shorts
durationstringoptional
Video length. Default "8s".
Values: 4s, 8s, 12s, 16s, 20s
creatorGenderstringoptional
Presented gender of the AI creator / talking head. Default "female".
Values: female, male
captionsbooleanoptional
Burn captions onto the video via ZapCap. Default true.
captionStylestringoptional
Caption look. Default "tiktok".
Values: tiktok, bold, clean, minimal
hookstringoptional
Optional opening hook line (max 200 chars). If omitted, the task generates one from productDetails.
referenceImageUrlstringoptional
Optional reference image URL (the "creator" face / look). Switches to image-to-video mode when provided.
offerIdstringoptional
Offer/product id this UGC clip is for. Get it from `vibiz_list_offers[].id`. When set, the chat agent's chosen offer is recorded on the resulting ad row so downstream tooling can reuse it. REQUIRED when the user said 'a UGC about my product' / 'spokesperson video for [thing I sell]' — call `vibiz_list_offers` first and ASK if multiple plausible offers exist.
icpIdstringoptional
Optional selected ICP/customer profile id. Use when the user names a target audience or when an offer has a clear linked ICP; it shapes the UGC hook and creator angle.
personaIdstringoptional
Optional persona id within the selected ICP. Use only when the user explicitly selects a persona.
lightingstringoptional
Per-call lighting override. Default 'auto'. Today the Sora UGC pipeline does not yet style on this — value is recorded on the ad for future pipelines + observability.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Today not yet wired into the Sora script; recorded on the ad row.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override (observable on ad row).
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
Brand kit assertiveness (observable on ad row).
Values: auto, subtle, standard, strong
logoModestringoptional
Logo stamping intent (observable on ad row).
Values: auto, on, off
compositionstringoptional
Composition intent (observable on ad row).
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
platformstringoptional
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
videoDurationstringoptional
Video length. Default "4s".
Values: 4s, 6s, 8s
videoResolutionstringoptional
Default "720p".
Values: 720p, 1080p
generateAudiobooleanoptional
Default true.
useBrandbooleanoptional
Apply workspace brand kit. Default true.
referenceImagesarrayoptional
Optional reference images. [0] is the primary reference, the rest are additional inputs.
offerIdstringoptional
Offer/product id this video is for. Get it from `vibiz_list_offers[].id`. When set, the underlying image (phase 1) is grounded to the product's title/price/image. REQUIRED when the user said 'a video ad for my product' / 'video for this offer' — call `vibiz_list_offers` first and ASK if multiple plausible offers exist.
lightingstringoptional
Per-call lighting override (applies to the image phase). Default 'auto'. Map user prose: 'dramatic' → dramatic, 'golden-hour' → golden-hour, 'softbox' → studio.
Values: auto, studio, natural, golden-hour, dramatic
moodstringoptional
Per-call mood override. Map: 'corporate' → professional, 'luxury' → premium, 'clean' → minimal.
Values: auto, professional, playful, premium, minimal, warm
cameraAnglestringoptional
Per-call camera angle override.
Values: auto, eye-level, low-angle, aerial, close-up
brandIntensitystringoptional
How loudly the workspace brand kit asserts itself.
Values: auto, subtle, standard, strong
logoModestringoptional
Whether to stamp the workspace logo on the image phase.
Values: auto, on, off
compositionstringoptional
Layout for the underlying image phase.
Values: auto, centered, rule-of-thirds, asymmetric, flat-lay

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

targetobjectoptional
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 /new-vibiz 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.
qualificationbooleanoptional
Optional. Set true to build a lead-qualification funnel (multi-step questionnaire + paywall/gating) instead of a single landing page. Default: false.
creativeIdstringoptional
Optional campaign_ad id to use as the hero image/reference for the page.
creativeImageUrlstringoptional
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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz 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.
titlestringoptional
Optional job title / role label that appears under the name (e.g. "Marketing Manager at a 50-person B2B SaaS").
descriptionstringoptional
Optional one-paragraph summary of who they are, what motivates them, and how the brand fits into their life.
demographicsobjectoptional
Optional demographic block. All fields free-form strings.
painPointsarrayoptional
Optional list of pain points / frustrations.
goalsarrayoptional
Optional list of goals / desired outcomes.
channelsarrayoptional
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

targetobjectoptional
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 /new-vibiz 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".
descriptionstringoptional
Optional details about the offer — terms, what is included, value prop. Max ~500 chars.
priceCentsintegeroptional
Price in cents (e.g. 9900 = $99.00). Omit for free offers / lead magnets.
priceCurrencystringoptional
ISO currency code. Default "USD".
typestringoptional
Business model type. Default "generic" if unsure.
Values: software, service, ecommerce, agency, generic
iconEmojistringoptional
Single emoji that represents the offer visually. E.g. "🎁", "💰", "🚀".

Workspace

3 tools

Read brand context and send branded transactional emails.

vibiz_workspace_generate_icps_pipeline

Bulk-discover Ideal Customer Profiles (ICPs / personas) from the workspace branding.

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

vibiz_workspace_generate_offers_pipeline

Bulk-discover marketing offers from the workspace branding / website.

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

vibiz_workspace_generate_knowledge_pipeline

Generate the workspace's business knowledge-base summary.

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.

Analytics

3 tools

Surface engagement, top-performing content, and reporting.

vibiz_analytics_top_posts

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter by platform (facebook, instagram, linkedin, tiktok, etc.). Omit for all.
sortBystringoptional
Metric to sort by. Default: engagement.
Values: engagement, impressions, reach, likes, comments, shares, date
fromDatestringoptional
Start date (YYYY-MM-DD). Default: 90 days ago.
toDatestringoptional
End date (YYYY-MM-DD). Default: today.
limitnumberoptional
Max posts to return (1-100, default 10).

vibiz_analytics_daily_metrics

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter to one platform. Omit for cross-platform aggregate.
fromDatestringoptional
Start date (YYYY-MM-DD). Default: 30 days ago.
toDatestringoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Platform to analyze. Omit for all platforms.

Inbox

4 tools

Read and reply to social-media inbox conversations.

vibiz_inbox_conversations

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter by platform (instagram, facebook, twitter, etc.).
limitnumberoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Filter by platform.
sortBystringoptional
Sort by date or comment count.
Values: date, comments
limitnumberoptional
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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz 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.

Meta ads

24 tools

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

vibiz_meta_ads_campaigns_list

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Values: facebook, instagram
statusstringoptional
Values: active, paused, pending_review, rejected, completed, cancelled, error
limitintegeroptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Values: facebook, instagram
statusstringoptional
Values: active, paused, pending_review, rejected, completed, cancelled, error
fromDatestringoptional
toDatestringoptional
limitintegeroptional

vibiz_meta_ads_campaigns_set_status

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

Parameters

targetobjectoptional
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 /new-vibiz 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 an internal 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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz 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
deepCopybooleanoptional
Default true.
statusOptionstringoptional
Default `PAUSED`.
Values: ACTIVE, PAUSED, INHERITED_FROM_SOURCE
startTimestringoptional
endTimestringoptional
renameStrategystringoptional
Values: DEEP_RENAME, ONLY_TOP_LEVEL_RENAME, NO_RENAME
renamePrefixstringoptional
renameSuffixstringoptional
syncAfterbooleanoptional
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

targetobjectoptional
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 /new-vibiz 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
platformstringoptional
Values: facebook, instagram
statusstringoptional
Values: active, paused, pending_review, rejected, completed, cancelled, error
campaignIdstringoptional
EXPECTS: Meta platform campaign id (16-18 digit numeric, e.g. "23859876543210000"). NOT an internal campaign id. Get it from `vibiz_meta_ads_campaigns_list[].platformCampaignId`.
fromDatestringoptional
YYYY-MM-DD
toDatestringoptional
YYYY-MM-DD
limitintegeroptional

vibiz_meta_ads_creatives_get

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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.
fromDatestringoptional
YYYY-MM-DD
toDatestringoptional
YYYY-MM-DD
breakdownsarrayoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
adIdstringrequired
Internal 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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
postIdstringoptional
EXPECTS: internal 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`.
platformPostIdstringoptional
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 it has been published on the platform. Provide ONE of `postId` or `platformPostId`.
accountIdstringrequired
EXPECTS: 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 an internal Mongo ObjectId.
namestringrequired
Ad name (max 255 chars).
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetobjectrequired
currencystringoptional
ISO-4217 currency code.
scheduleobjectoptional
targetingobjectoptional
bidAmountnumberoptional
Meta only.
trackingobjectoptional
Meta only.
specialAdCategoriesarrayoptional
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

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
accountIdstringrequired
EXPECTS: 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).
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetAmountnumberrequired
Budget amount in the ad account currency. Minimums: Meta=$1/day, TikTok=$20/day, Pinterest=$5/day.
budgetTypestringrequired
Values: daily, lifetime
currencystringoptional
headlinestringoptional
bodystringoptional
callToActionstringoptional
Meta only.
Values: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE
linkUrlstringoptional
imageUrlstringoptional
videoobjectoptional
Meta only.
adSetIdstringoptional
Meta only — attach this creative to an existing ad set. Mutually exclusive with `creatives[]`.
countriesarrayoptional
ageMinintegeroptional
ageMaxintegeroptional
interestsarrayoptional
endDatestringoptional
Required for lifetime budgets.
audienceIdstringoptional
advantageAudienceintegeroptional
Advantage Audience flag. 0 = off, 1 = on. Constrained via minimum/maximum (not enum) so Gemini accepts the schema.

vibiz_meta_ads_launch_bulk

Parameters

targetobjectoptional
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 /new-vibiz 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
Campaign name (max 255 chars). Each ad inside the campaign gets an auto-numbered name from Meta.
goalstringrequired
Values: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion
budgetAmountnumberrequired
Shared budget for the whole ad set (NOT per-ad). Meta=$1/day minimum.
budgetTypestringrequired
Values: daily, lifetime
currencystringoptional
ISO-4217 currency code.
creativesarrayrequired
Array of ad creatives. Each entry needs exactly one of `imageUrl` or `video`. All other fields are required.
countriesarrayoptional
ageMinintegeroptional
ageMaxintegeroptional
interestsarrayoptional
endDatestringoptional
Required for lifetime budgets.
audienceIdstringoptional
advantageAudienceintegeroptional
Advantage Audience flag. 0 = off, 1 = on. Constrained via minimum/maximum (not enum) so Gemini accepts the schema.

vibiz_meta_ads_accounts_list

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

Parameters

targetobjectoptional
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 /new-vibiz or (b) ask them to pick from the available vibiz. Do not generate with the wrong brand.
socialAccountIdstringrequired
EXPECTS: 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

targetobjectoptional
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 /new-vibiz 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
socialAccountIdstringoptional
Required for separate-token platforms (tiktok, twitter); ignored for same-token + standalone.
redirectUrlstringoptional
Custom URL to redirect the user back to after OAuth (same-token platforms only).

vibiz_meta_ads_pixels_create

Provision a new Meta Pixel under a Meta ad account. Returns the pixel id and the install snippet (`tag.code`) the user pastes into their site (or the assistant injects into a generated funnel).

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`.
namestringrequired
Human-readable pixel name shown in Meta Events Manager. Tip: include the workspace name so a user with multiple pixels can tell them apart (e.g. 'NeceSera — Main Site Pixel').

vibiz_meta_ads_pixels_list

List every Meta Pixel reachable through the given social account. Pass `adAccountId` to scope to one ad account.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
adAccountIdstringoptional
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`. OPTIONAL — omit to list pixels across every ad account on this social account.

vibiz_meta_ads_pixels_get

Fetch one Meta Pixel by id, including the install snippet (`code`) and `lastFiredTime`.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).

vibiz_meta_ads_pixels_stats

Pixel event performance broken down by an aggregation dimension (event / host / url / device_type).

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
aggregationstringoptional
Aggregation dimension. Defaults to Zernio's server-side default (event) when omitted.
Values: event, host, url, device_type

vibiz_meta_ads_pixels_update

Rename a pixel or toggle Meta's feature flags on it (Advanced Matching, first-party cookies, data-use setting).

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
namestringoptional
enableAutomaticMatchingbooleanoptional
firstPartyCookieStatusstringoptional
dataUseSettingstringoptional

vibiz_meta_ads_pixels_share

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`. This is the RECIPIENT ad account that should gain access — NOT the ad account the pixel was originally created on.

vibiz_meta_ads_pixels_list_shares

List the Meta ad accounts this pixel is currently shared with. Pair with `vibiz_meta_ads_pixels_share` / `_unshare` to audit and tighten permissions.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).

vibiz_meta_ads_pixels_unshare

Revoke a Meta ad account's access to this pixel. Closest thing to 'delete' since Meta does not expose a pixel-delete endpoint.

Parameters

targetobjectoptional
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 /new-vibiz 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` or `vibiz_meta_ads_accounts_list` ancestor.
pixelIdstringrequired
EXPECTS: Zernio tracking-tag id (returned as `tag.id` from `vibiz_meta_ads_pixels_create`, or `data[].id` from `vibiz_meta_ads_pixels_list`).
adAccountIdstringrequired
EXPECTS: Meta platform ad account id (string starting with "act_"). Get it from `vibiz_meta_ads_accounts_list[].id`.

Generation

Workspace

Analytics

Inbox

Social

Meta ads

Generation

Workspace

Analytics

Inbox

Social

Meta ads