Influee

The creator, an independent person on Influee, is notified that delivery is confirmed. Confirm that the creator received the product for a collaboration with task type CONFIRM_DELIVERY (backend OVERDUE_SHIPMENT). Delivery = brand confirms the creator has received the product. Send-side confirmation (brand shipped it) is the separate SHIPMENT task.

confirm_delivery

Confirm the product preferences a creator submitted during onboarding. The creator, an independent person on Influee, is notified, and the collaboration moves to the active state. Only valid while the collaboration is in the awaiting_shipment or awaiting_confirmation state and does not ship a product — rejects with an error naming the state for any other state. Rejects with ACCESS_DENIED when the collaboration is not accessible to the viewer, and with COLLABORATION_ACTION_UNAVAILABLE while a dispute is open on it. Returns the collaboration id and new state.

confirm_product_preferences

The creator, an independent person on Influee, is notified that the product is on its way. Confirm shipment for a collaboration with task type SHIPMENT. Shipment = brand confirms the product has been sent. Delivery confirmation (creator received it) is the separate CONFIRM_DELIVERY task. Provide exactly one of `tracking_link`, `tracking_code`, or `estimated_delivered_at`. `estimated_delivered_at` applies to non-shipping collaborations (digital products, services).

confirm_shipment

Create a new brand from its website. The website is read for the brand's name, logo (its Instagram profile photo, or else the site's main image), Instagram and TikTok accounts, and description. Any name, tag, profile_photo, instagram_username or tiktok_username passed replaces what the website gave. If the website cannot be read, the brand is created from the passed fields alone, without a logo; that needs a name, and without one the call fails.

create_brand

Create a draft campaign for creator recruitment. Rules: (1) title, objective, description and recruitment_type are required. (2) For objective influencer_post_social, nano_influencers + micro_influencers + macro_influencers is required to be greater than 0; for every other objective, content_creators is required to be greater than 0. (3) recruitment_type "public" requires recruitment_countries, recruitment_categories, recruitment_ages (each [] for no restriction) and recruitment_gender ("any" for no restriction); "invite_only" does not use them. (4) budget_custom_value is accepted only for a company with the custom budget feature enabled; otherwise the call fails with CUSTOM_BUDGET_NOT_ENABLED. (5) cover_photo, if set, is an Influee media ID or an image URL, which is downloaded and checked to be a reachable image. A call that breaks rule 1, 2, 3 or 5 returns an error naming it and creates no draft; the rule 4 error comes back after the empty draft exists. Also accepts every other campaign field in the input schema. Returns the campaign ID and editor link; the campaign stays a draft until it is submitted for review.

create_campaign

Create a draft collaboration for a specific creator. creator and brand are REQUIRED; creator/campaign/brand accept an ID or a name — on ambiguity returns candidate IDs to retry with. Pick `type` (see its own field — reward_type/reward requirements depend on it). The draft opens in the dashboard sidebar for the user to finish; the brand's default payment method is auto-attached and nothing is sent to the creator yet (no notifications/messages/tasks). Only creator and brand are required; campaign and every other field are optional and can be set later. The draft stays unsent until it is explicitly sent to the creator.

create_collaboration

Create a content label (the tags shown in the content library) for your workspace and return its id and text. A label that is on no content is removed the next time a save takes a label off any content, so apply it to content soon after creating it.

create_content_label

Create a new creator list. Title auto-generates as "List #N" if not provided.

create_list

Create a new product. If only a website URL is provided (no name, description, etc.), AI will automatically scrape the website and populate all product details. Otherwise, provide at least a name to create the product manually.

create_product

Create a public share link to a delivered content item, creative asset, creator profile, TikTok video, Instagram post, list, collaboration, or campaign. Anyone with the link can view it without logging in. Returns the share link, including its public `url`. target_id is the id of the shared entity: a delivered content item id, a creative asset id or a creator id (or the TikTok video / Instagram post id).

create_share_link

Saves a skill document in Influee. With group scope it is shared with every user in the company, and Influee's dashboard assistant follows its content when the skill is used. Save a new skill: a reusable markdown workflow document for the user's Influee workspace (e.g. brand voice guidelines, response templates, workflow checklists). The 'content' field holds the document's markdown text. Name is lowercase alphanumeric with hyphens only (e.g. 'brand-voice', 'review-checklist'). Scope determines visibility: 'group' shares the skill with all users in the company, 'account' keeps it private to the current user.

create_skill

The creator, an independent person on Influee, is notified that the proposal was declined. Decline a creator's proposal. Only valid when the collaboration is in 'proposal' state — rejects with INVALID_STATE_TRANSITION otherwise (offers/invites are withdrawn, not declined). Optionally blacklists the creator from future matching.

decline_collaboration

Delete a campaign. This action cannot be undone.

remove_campaign

Permanently delete a list. This cannot be undone.

remove_list

Delete a product. This action cannot be undone.

remove_product

Delete a saved skill document. Cannot delete system skills. This action cannot be undone.

delete_skill

Dismiss a creator's proposal, or restore it. Dismissing hides it from the brand's open negotiations without declining it: the creator is not notified, the state does not change, the proposal still expires on its usual schedule, and the dashboard lists it with the failed negotiations. Dismissing also removes it from the shortlist. Returns the collaboration's `shortlistedByBrand` and `archivedByBrand` (true when dismissed). Errors: ACCESS_DENIED, COLLABORATION_NOT_FOUND, and INVALID_STATE_TRANSITION when the collaboration is not a proposal.

dismiss_collaboration

Draft a chat message to a creator. Saves it as the AI assistant's draft in the conversation, shown to the brand team as a suggestion beside their own drafts; drafts people typed stay as they are. One assistant draft per conversation is stored — saving overwrites the previous assistant draft. Drafts are not sent automatically; a person reviews and sends it in the dashboard, and the message goes out under their name. Saving a draft is NOT subscription-gated — it works even when the creator is blocked by PAST_DUE_SUBSCRIPTION or CANCELED_SUBSCRIPTION (only sending is gated), so it still works when sending is blocked. Requires conversation_id in "brandId-creatorId" format — no prior conversation needed.

create_draft_message

Duplicate a self-service campaign into a new draft. Copies the brief, default terms, recruitment settings, personas, collaboration groups, creative assets, tracking link templates, and additional details. The new campaign's title is the original title with " - Copy" appended; the title can be changed afterwards. Returns the new campaign with its ID and editor link.

duplicate_campaign

Duplicate an existing creative asset. Creates a copy with the same type, settings, and products on the same campaign.

duplicate_creative_asset

Update a list's title and/or description.

edit_list

Fetch a single Influee ad-script source (a winning UGC ad reference) by ID. Returns the source's `title`, `htmlScript` (the original script content), and `angle` (storyline category like `problem_solution`, `testimonial`, `unboxing`, etc.). Typically read as a reference before adapting the script for another brand and product.

get_ad_script_source

Get detailed information about a brand by ID or name. Returns name, tag, profile photo, website, and payment method.

get_brand

Get detailed information about a campaign by ID or title. Returns type, state, objective, brand, budget, recruitment, brief, collaborations, delivered content, the view window (days after posting that a post keeps counting views), and insights including the total views, likes, comments, shares and saves of the posted Instagram posts and TikTok videos.

get_campaign

Get detailed information about a single collaboration by ID. If the creator's `username` is `null` and `hideSensitiveInformationReason` is set (PAST_DUE_SUBSCRIPTION, CANCELED_SUBSCRIPTION, or NO_COLLABORATIONS), the username is gated for this brand; `personalDetails.firstName` is still returned. PAST_DUE_SUBSCRIPTION and CANCELED_SUBSCRIPTION also block sending messages (NO_COLLABORATIONS does not). A non-null `requestedEdit` means the brand has a pending edit awaiting the creator's acceptance: the top-level fields are the current (unchanged) values and `requestedEdit` holds the proposed reward/terms/assets. `deadline` (when set) is the live content-delivery deadline — `endedAt` is when content is due and `type` distinguishes normal delivery / revision / missed / completed phases. `contentDeliveryTime`/`contentDeliveryDate` are the pre-activation delivery config (null = campaign default). `hasOtherCampaignCollaboration` is true when the creator already has another open or ongoing collaboration on the same campaign — sending or accepting this one creates a second collaboration with its own payment.

get_collaboration

Read the comments on a piece of content, oldest first. Takes exactly one target: delivered_content_id, ad_id, creative_asset_id, tiktok_video_id or instagram_post_shortcode. Returns count (all comments, ignoring paging), offset and items. Each item has id, sentAt and, for a written comment, sender (BRAND, INFLUENCER or PLATFORM), content, note (true for an internal note the creator does not see), sentByAssistant, account (id of the brand team member who wrote it), influencer (id of the creator who wrote it), and where it is pinned: annotationTimestamp and annotationEndTimestamp in seconds, annotationX and annotationY as fractions from 0 to 1. Automatic activity entries such as an approval or an upload carry only id and sentAt. Set annotated_only to get just the pinned comments. Rejects with ACCESS_DENIED when the target does not exist or belongs to another account.

get_content_comments

Get a messaging conversation with a creator, including chat messages and own draft. The conversation_id is just "brandId-creatorId" (e.g. "42-17") — no prior conversation needed; an unused pair returns an empty messages list. If the creator's `username` is `null` and `hideSensitiveInformationReason` is set (PAST_DUE_SUBSCRIPTION, CANCELED_SUBSCRIPTION, or NO_COLLABORATIONS), the username is gated for this brand; `personalDetails.firstName` is still returned. PAST_DUE_SUBSCRIPTION and CANCELED_SUBSCRIPTION also block sending messages (NO_COLLABORATIONS does not), and hide the creator's message text: those messages come back with `content: null`. They are not empty messages; the text is hidden until the brand's subscription is active again.

get_conversation

Get detailed information about a single creative asset by ID. Returns the asset with its title, type, number of creatives, duration, crop, hashtags, html_script (brief), state, deadline, dashboard link, associated products, parent campaign/collaboration references, and attached brief documents as document_ids + document_count only.

get_creative_asset

Get one document attached to a creative asset's brief, including its readable content when available. Documents are attached Google Docs/Sheets/Slides/Drive files, public Notion pages, public Canva designs, or uploaded files; their ids are the document_ids listed on a creative asset. When the document has a stored text copy the response includes markdownContent — the document's full text. Google Docs and Notion pages have one in every case; Sheets (rendered as tables), Slides, Drive files, Canva designs and uploaded files (pdf/docx/txt/md) have one whenever text extraction succeeded. When markdownContent is absent, fileUrl (the exported PDF or the uploaded file) and sourceUrl (the original link) are the remaining sources. status 'pending' means the export is still running — retry in a few seconds. status 'error' means the last fetch failed — see errorReason ('not_accessible' means sharing is restricted; once link access is enabled, the document can be re-added by its URL).

get_creative_asset_document

Get detailed information about a single creator by ID or name/username. Returns profile, categories, pricing, rating, collaboration count, and the creator's shipping/personal details under `personalDetails` (firstName, lastName, addressLine1, addressLine2, city, postalCode, stateProvince, country, mobileNumber, email). On ambiguity, the tool returns candidate IDs — retry with one of them. Sensitive fields are gated by `hideSensitiveInformationReason`: when it is set (PAST_DUE_SUBSCRIPTION, CANCELED_SUBSCRIPTION, or NO_COLLABORATIONS) the `username` and every `personalDetails` field except `firstName` and `country` come back `null`. The full shipping address (and the other masked fields) only populate once the brand has an ongoing collaboration with this creator — i.e. after the creator has been accepted — so this is where to read the shipping address once a collaboration is active. PAST_DUE_SUBSCRIPTION and CANCELED_SUBSCRIPTION also block sending messages (NO_COLLABORATIONS does not). A brand without an active paid subscription can view a limited number of new creators in any 24 hours; past it, the lookup fails with DAILY_CREATOR_LIMIT_REACHED. Creators viewed earlier that day and creators the brand already works with still load.

get_creator

List the ratings the viewer's company gave a creator, one row per rated collaboration: the content, communication and deadline scores (1 to 5), when it was rated, the id of the account that rated it, the collaboration's state and completion date, and the ids of its brand and campaign. Only collaborations of the viewer's company count; ratings other companies gave the creator and the platform-wide average are not included. The rater's account id is null for a rating given before raters were recorded. Collaborations without a rating, or whose rating an admin removed, are left out. `count` is the number of rated collaborations, 0 when the company has not rated the creator.

get_creator_ratings

Return the currently authenticated user: account info (id, email, name, role, locale), the active group ID, and the company (id, name). Use this to identify who is logged in and which group/company context the other tools operate in.

get_viewer

Get full detail for one delivered content item by its ID: its collaboration, creator, the linked creative asset (the brief it was produced for), its review status, and all transcriptions as full readable transcript text per language. Review status comes from the content approval the creator submitted: contentApprovalId, reviewState (in_review, approved, declined, expired, draft or uploading) and reviewedAt; all three are null for content without a review step, such as an import. Only `pro` (professionally transcribed, delivered before that service was retired) transcriptions are returned when the company has no ad-creator subscription. An empty transcriptions list means the automatic transcription is not ready yet (it follows the upload by a few minutes) or the video has no speech.

get_delivered_content

Fetch one saved agent document by id, including its full markdown content.

get_document

Creates a signed link for uploading a local file to Influee storage. The client sends the file bytes with an HTTP PUT to upload_url, with the returned Content-Type header and no other authentication; the link expires after 60 minutes. The response also holds file_url, the address the file has once uploaded, which is what tools that take a file link accept. Purposes: document — a pdf, docx, doc, txt or md file up to 25 MB, used as a creative asset document; message_attachment — a file, photo or video sent to a creator in a conversation. The file name keeps only its extension; the stored name is generated. Errors: no extension in file_name; unknown purpose; UNSUPPORTED_FILE_FORMAT — a document that is not a pdf, docx, doc, txt or md file; FILE_TOO_LARGE — a document whose file_size is over 25 MB.

get_upload_url

Get a list with its creators. Returns creator IDs, usernames, and first names. Returns up to 20 creators per call by default (limit sets the page size, up to 25); paginate with offset for more. If a creator's `username` is `null` and `hideSensitiveInformationReason` is set (PAST_DUE_SUBSCRIPTION, CANCELED_SUBSCRIPTION, or NO_COLLABORATIONS), the username is gated for this brand; `personalDetails.firstName` is still returned. PAST_DUE_SUBSCRIPTION and CANCELED_SUBSCRIPTION also block sending messages (NO_COLLABORATIONS does not).

get_list

Get detailed information about a product by ID or name. Returns name, description, website, photo, value, options, usage instructions, and associated brand.

get_product

Get one saved skill document by ID, including its full markdown content.

get_skill

The creator, an independent person on Influee, is not notified. Launch a dispute on an accepted, in-progress collaboration — this opens a dispute for the Influee support team to review. The collaboration keeps its current state and gets a `disputedAt` timestamp while the dispute is open; creator and brand actions that advance it, content uploads and the automatic follow-ups pause until the dispute is cancelled or the Influee team resolves it. Only valid while the collaboration is in one of these states: awaiting_payment, onboarding, awaiting_shipment, awaiting_confirmation, awaiting_info, awaiting_product, active. Rejects with COLLABORATION_NOT_DISPUTABLE for any other state (drafts, unaccepted offers/invites, proposals, completed, or failed), and with DISPUTE_ALREADY_EXISTS if a dispute is already open. Unaccepted offers/invites are withdrawn and creator proposals are declined rather than disputed.

launch_dispute

List Influee ad-script sources (winning UGC ad references) with optional filters. Returns lightweight items ({ id, title, angle, duration, instagramAccount.username }); the full `htmlScript` is not included and is retrieved per source ID. Useful for finding a reference by angle, duration or brand vibe when no specific reference ID is known. Defaults: `order_by=recommended`, `limit=10`.

list_ad_script_sources