Tools Reference

Returns the workspace the connected key is scoped to (name, id, slug). Call first to confirm the connection.

Creates a draft sourcing campaign from a brief and targeting criteria (gender, country, follower and avg-view ranges, seed creators, specificity 1–5, hashtags; audience-demographic rules are YouTube-only). Platforms: instagram, youtube, tiktok. Created with sourcing OFF — nothing is contacted and no budget is spent until sourcing is explicitly started.

Launches the sourcing agent for a campaign (by id or code). Enables sourcing, moves a draft to live, and starts a queued run. Spends sourcing budget.

Returns the status of a sourcing run (queued, running, paused, paused_human), leads found, leads processed, and the dashboard URL.

Lists creators the workspace works with (those with at least one deal), most-active first. Returns name, profiles (handle/platform), deal count, deal codes. Paginated (default 20, max 100).

Same shape as list_creators, filtered by handle substring, name substring, and/or platform.

Bulk export with the complete field set per creator (email, country, city, gender, languages, content summary, profiles with view estimates, deal codes) for analysis or CSV. Default 200, max 500 per page.

Lists campaigns newest first: id, code, name, status (draft/live/archived), budget, start/end dates. Filterable by status; paginated.

Full detail of one campaign by id or code: description, platform, budget, dates, hashtags, brief URL, target creator count/countries, follower/view range, sourcing status.

Lists deals newest first: code, stage (outreach/negotiation/contracting/onboarding/content_review/post_tracking/declined), status, creator, campaign, agreed amount. Filterable by stage; paginated.

Full detail of one deal by id or code, including rate, deliverable type, post date, contract-signed and declined info.

Signed agreements, most recently accepted first: code, status (accepted/pending), amount, currency, posting window, deal code, creator. Paginated.

Acceptance status and detail of one contract by id or code, including brief URL and associated deal/creator.

Recent creator email threads by last activity: subject, matched creator, read state, last message time. Paginated.

One thread’s full message history, oldest first: direction (inbound/outbound), addresses, sent time, body text.

Creator posts Passo matched to deals (deliverables that actually went live), Instagram and YouTube: post URL, publish date, deal/campaign/creator, match date. Filterable by date; paginated.

Returns the flow building blocks: trigger types, step types (send_email, wait, human_pause, branch, generate_contract, …) with required config, and structural constraints. Call before creating a flow.

Flows most recently updated first: name, status (draft/published), active state, version, in-flight and 30-day run counts.

Run history for one flow: per-run status (running/paused_human/completed/errored/cancelled), current step, timings, error message if failed.

Creates an inactive draft flow from a structured definition. Never runs on live triggers on creation — the user reviews in the dashboard flow builder separately. Returns flowId, flow-builder URL, and validated definition.

Publishes an existing draft flow so it runs on live triggers. Deliberate separate step; re-validates before going live and refuses with named errors if the flow would not execute.