All guides
What Goodbird can do
Goodbird's tools come in three kinds. Reads answer immediately and change nothing. Work inside your own workspace runs directly: drafting, searching, matching and shortlisting reach nobody, and searches run on Goodbird's own budget rather than yours. Anything that reaches a creator, spends your money or can't be undone asks you first, every time.
This page is generated from the live catalogue, so it is always what a connected assistant actually sees. A connected assistant also gets check_approval, to find out what you decided about something it proposed. Goodbird in the app also remembers lasting facts you tell it. A connected assistant cannot, because that memory belongs to your conversations in Goodbird.
On this page · 6 sections
Get your bearings
Reads that tell an assistant which workspace it is in and how each campaign is going. These answer immediately and change nothing.
Check whether Goodbird has read your site
Readread_site_dossier_statusSays which domain is linked to your workspace and when Goodbird last read it.
List a campaign's creators
Readlist_campaign_creatorsShows a campaign's ranked creators, where each one stands and what has been decided about them. Narrow it to the shortlist, the ones still to review, or the ones you passed on.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.segmentOptionalShow only creators at this decision, or `undecided` for everyone nobody has acted on yet.limitOptionalHow many creators to show, up to 24.
Read a campaign
Readread_campaignReads one campaign the way its workspace shows it: the budget, what you asked for, the ranked creators, the shared creative direction, and where the work stands.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Read one brand fact
Readread_brand_factReads one brand fact in full, retired or not.
Details
brandFactIdRequiredWhich fact, as read_brand_facts names it (its brandFactId).
Read the campaigns assigned to you
Readread_my_campaignsLists the campaigns you are assigned to, newest first, with how many unread notifications each one has.
Read the notes behind a brand fact
Readread_brand_fact_evidenceReads the review notes a fact caught and the ones it was learned from, each with the script line and a link to the piece.
Details
brandFactIdRequiredWhich fact, as read_brand_facts names it (its brandFactId).
Read your brand facts
Readread_brand_factsReads what Goodbird knows to be true about your product: each fact, the mistake it guards against, and whether it is active.
Details
includeRetiredOptionalTrue to include retired facts as well.
Read your notifications
Readread_my_notificationsReads your recent notifications, newest first: what happened, on which campaign, and whether you have seen it.
Details
unreadOnlyOptionalTrue for only the ones the person has not read yet.
Read your workspace
Readmy_business_contextReads your company profile and recent campaigns, so an assistant knows which workspace it is acting for.
Recall earlier campaign conversations
Readlist_campaign_assistant_summariesReads summaries of your own earlier Goodbird conversations inside each campaign: what was discussed and decided.
See how your collabs are going
Readmy_campaign_progressReads every collab across your campaigns and leads with the ones that need a decision: work waiting on your review, deadlines that have passed, and invoices still to come.
See what needs you
Readread_needs_youReads everything waiting on you across the workspace, the same list the Inbox shows: decisions by campaign, sign-offs asked of you, and actions waiting on your approval.
See what your brand facts have caught
Readread_brand_fact_catchesReads how often each active fact has caught a script, and when it last did.
See who is on a campaign
Readlist_campaign_teamLists the teammates assigned to a campaign.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
See whose script each example came from
Readread_brand_fact_attributionsReads which creator wrote the line each fact's example quotes.
Find the cast
Search for creators, steer the search, and decide who makes the shortlist.
Drop a steering direction
Runs directlyremove_search_directionRemoves a steering direction so the next round of a campaign's creator search no longer follows it. Nothing is sent, and you can add it again in the same words.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.directionIdRequiredWhich direction to remove, from list_search_directions.textRequiredThe direction's exact current text, as you read it.
Explain why a creator is missing
Readexplain_creator_absenceSays why a named creator is not among a campaign's creators — excluded on category, under a floor you set, or simply ranked below the ones you were shown.
Details
creatorNameOrSlugRequiredThe creator you are asking about, by display name or slug.campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Look up creator profiles
Readfind_creatorsLooks up admitted creators by name, handle or profile text; ranked discovery is a campaign's search round.
Details
queryOptionalLiteral creator name, handle, location or other profile text to look up; not a transcript topic or evidence request.limitOptionalHow many creators to bring back, up to 12.
Pass on a creator
Runs directlyset_match_statusPasses on one suggested creator, or puts one back for review. The creator is never told, and you can change your mind at any time.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.reasonOptionalreasonOnlyOptionalexpectedDecisionRevisionOptionalmatchIdRequiredWhich suggested creator this is about, from the matchId read_campaign or list_campaign_creators returned.statusRequiredPass on this creator, or put them back in the pile to review again.
Read a creator
Readread_creatorReads one creator's reach, how they stand against a campaign's ask, and where any offer to them has got to.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.
Read a search round
Readread_search_roundReads one round of a campaign's creator search: whether it is still working, how the campaign's filters narrowed the creators it considered, and who it found.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.runIdOptionalThe round to read, as start_search_round returned it.
Read creator search vocabulary
Readread_creator_search_vocabularyReads the supported taxonomy questions and option labels.
Details
limitOptionalstartingAfterOptionaltaxonomyOptionalqueryOptional
Read your steering directions
Readlist_search_directionsReads the steering waiting on a campaign's creator search — the notes the next round will pick up, before they are folded into the campaign's own wording.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.includeRemovedOptionalAlso list directions that have been removed, which no round will follow.
Shortlist a creator
Runs directlyset_shortlistedAdds a creator to your campaign shortlist. Nothing is drafted and nothing is sent — composing an offer and contacting them are later steps you take.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.reasonOptionalreasonOnlyOptionalexpectedDecisionRevisionOptionalonRequiredTrue to shortlist the creator, false to take them off the shortlist again.
Start a search round
Runs directlystart_search_roundStarts a new round of creator search for one campaign. The round runs in the background and adds what it finds to the campaign's creators. Nothing reaches a creator.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.searchModeIdOptionalsearchPlanOptionalShared editable plan: preserve the complete request as query, select exact taxonomy terms from read_creator_search_vocabulary including format/teaching, and.limitOptionalHow many creators this round admits, up to 10, the most one round returns.
Steer the creator search
Runs directlyadd_search_directionAdds one line of steering, such as more of this and less of that, for the next round of a campaign's creator search. Nothing is sent to anyone.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.textRequiredThe steering itself, in one short line — for example, more ritual, less polish.sourceOptionalfree_text for conversational tuning, chip when relaying a set phrase.
Do the deal
Prepare offers and settle terms. Anything that reaches a creator waits for your yes.
Accept a creator's terms
Asks firstaccept_offerAccepts the terms a creator has proposed. Accepting fixes those exact terms and creates the work you agreed. Nothing is decided until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalThe creator whose collab you are accepting: a name, slug, @creator/<slug> mention or id.expectedVersionRequiredThe collab terms version you read from list_campaign_collabs.counterpartyNameRequiredThe creator you understand you are agreeing with.
Decline a creator's terms
Asks firstdecline_offerTurns down the terms a creator has proposed. Nothing is charged, and either side can propose again. Nothing is decided until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalThe creator whose collab you are declining: a name, slug, @creator/<slug> mention or id.expectedVersionRequiredThe collab terms version you read from list_campaign_collabs.counterpartyNameRequiredThe creator you understand you are turning down.
Draft a personal note
Runs directlydraft_personal_noteWrites a first pass at the note explaining why this campaign wants this creator. Nothing is saved or sent until you put it on the offer.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.
Edit a draft offer
Runs directlyupdate_offerSets the fee, deliverables, deadline, rights and personal note on a draft nobody has been sent yet. Nothing goes out until you send it. Content rows name a catalogue preset and quantity. Optional channels, route, lengthSeconds, description, dueAt and budgetShare override that preset. Integrated mentions need an explicit paid duration; never invent it. Dates are ISO instants. Rights presets replace the entire rights list: sponsored includes organic reuse for 365 days; amplified adds whitelisting for 90 days; creative_only adds paid ads for 90 days. Licences start at go-live. none grants no extra rights; keep preserves every existing licence and priced option. Use keep when changing other terms. Deliverables may also be keep to preserve the full existing list, including custom formats. New custom rights and formats are edited in the app. Fees and budgets are integer minor units of the workspace currency; a single budget figure is its ceiling.
Details
amountMinorOptionaldeadlineOptionaldeliverablesOptionalrevisionsOptionalrightsOptionalexclusivityOptionalcancellationTermsOptionalbonusOptionalwhyYouOptionalexpiresInDaysOptionalcampaignOptionalcreatorOptional
Put terms on the table
Asks firstpropose_offer_termsSends an offer, counters one, or replaces terms you have already proposed — one action, whichever turn of the negotiation it is. Nothing goes out until you approve it, on a card showing every term. Content rows name a catalogue preset and quantity. Optional channels, route, lengthSeconds, description, dueAt and budgetShare override that preset. Integrated mentions need an explicit paid duration; never invent it. Dates are ISO instants. Rights presets replace the entire rights list: sponsored includes organic reuse for 365 days; amplified adds whitelisting for 90 days; creative_only adds paid ads for 90 days. Licences start at go-live. none grants no extra rights; keep preserves every existing licence and priced option. Use keep when changing other terms. Deliverables may also be keep to preserve the full existing list, including custom formats. New custom rights and formats are edited in the app. Fees and budgets are integer minor units of the workspace currency; a single budget figure is its ceiling.
Details
titleRequiredamountMinorRequireddeadlineOptionaldeliverablesRequiredrevisionsOptionalrightsOptionalexclusivityOptionalcancellationTermsOptionalnotesOptionalbonusOptionalmandatoriesOptionalcampaignOptionalcreatorOptionalexpectedVersionRequiredcounterpartyNameRequired
Read your collabs
Readlist_campaign_collabsReads every collab on a campaign with the terms exactly as they stand today, and whose turn it is to act.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Read your draft offers
Readread_offersReads every draft offer prepared for a campaign — who is on the offer sheet, the fee, the deliverables, and whether a personal note has been written yet.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Start an offer
Runs directlycreate_offerOpens a draft offer for a creator on a campaign, prefilled from the campaign's budget and deliverables. Nothing is sent. If the creator already has an offer on the campaign, you get that one back.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.
Withdraw your offer
Asks firstvoid_offerTakes back an offer, so the creator can no longer accept it. Nothing is withdrawn until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalThe creator whose collab you are withdrawing: a name, slug, @creator/<slug> mention or id.counterpartyNameRequiredThe creator you understand this offer to be with.
Stay in touch
Read your conversations with creators, and send a message once you approve it.
Discard a follow-up
Runs directlydiscard_follow_upThrows away the follow-up Goodbird drafted on a quiet thread, and starts the wait again. Nothing goes out either way.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.
List your conversations
Readlist_campaign_conversationsReads who you have spoken to on a campaign, with the latest message in each conversation.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Read a conversation
Readread_conversationReads one conversation with a creator in full, so a summary or a suggested reply comes from what was actually said.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.conversationIdRequiredWhich conversation to read, exactly as list_campaign_conversations or list_campaign_collabs gave it.
Read the email thread
Readread_outreach_threadReads the emails exchanged with a creator from your own mailbox, what Goodbird read their last reply as, and whether a follow-up is waiting to be sent.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.
Record a rate from a reply
Runs directlyrecord_reply_ratePuts the figure a creator named in an email onto their rate request, where a priced offer reads it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.amountMinorRequiredThe fee in minor units of `currency`, an integer: £4,000 is 400000, the same as every other money argument.currencyRequiredThe currency the creator named it in.
Send a message
Asks firstsend_messageSends a message to a creator on a campaign, starting the conversation if there is not one yet. It can carry a decision on their offer: accept, decline, counter or send it. Nothing goes out until you approve it, and the card shows the decision and the words together.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.bodyRequiredThe message itself, written in full and ready to send.decisionOptionalWhat this message commits on the creator's offer, when it commits anything.
Deliver and settle
Follow submitted work, review it, read the results, and issue the final invoice.
Approve a piece with your notes
Asks firstapprove_with_notesApproves a submitted piece and sends the creator the notes your team wrote on it, for them to pick up when they post. Nothing is sent until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.deliverableIdRequiredWhich promised piece, from read_campaign_delivery.
Approve or ask for changes
Asks firstreview_deliverable_revisionApproves one piece of submitted work, or asks the creator for changes with your feedback. Nothing reaches the creator until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.offerIdRequiredWhich collab the piece belongs to, from read_campaign_delivery.deliverableIdRequiredWhich promised piece is being reviewed, from read_campaign_delivery.creatorNameRequiredWho made the piece, exactly as read_campaign_delivery gave it.deliverableLabelRequiredWhat the piece is called, exactly as read_campaign_delivery gave it.submissionUrlRequiredThe link the creator submitted, exactly as you read it.expectedRevisionRequiredWhich revision of the piece you are reviewing, from read_campaign_delivery.decisionRequiredApprove the submitted piece, or send it back with notes for another pass.feedbackOptionalWhat the creator should change, in your own words.
Ask a teammate to sign off a piece
Runs directlyrequest_sign_offAsks a named teammate to look at a submitted piece before it is approved. They get a notification that opens the piece.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.deliverableIdRequiredWhich promised piece, from read_campaign_delivery.teammateRequiredThe teammate, by name or email, as the user said it.
Confirm your boost spend
Asks firstconfirm_boost_queueCommits everything in the boost queue and raises one invoice for it. This spends money, and nothing is committed until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Exercise a pre-priced option
Asks firstexercise_offer_optionBuys one pre-priced amplification option, at exactly the price agreed when the deal was signed. This spends money, and nothing is billed until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.optionIdRequiredThe option's id, exactly as read_offer_options named it — never invented.
Mark a piece live
Asks firstset_piece_liveMarks an approved piece as live. If any agreed creator fee on the campaign is not billed yet, this raises the campaign invoice. Nothing changes until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.deliverableIdRequiredWhich promised piece, from read_campaign_delivery.
Queue paid media spend
Runs directlyqueue_boostAdds paid media spend behind one creator's live piece. Nothing is committed and no invoice is raised until you confirm the whole boost queue.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.pieceOptionalWhich live piece, by its platform or its format — "YouTube", "short", "TikTok video".amountMinorRequiredThe boost spend for this piece in the minor units of the campaign currency, an integer: 250.00 is 25000.
Read a campaign's invoices
Readread_campaign_invoicesReads what a campaign has been billed: the invoice raised when its first piece went live, any media invoice for boosts, and when each creator is due to be paid.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Read a collab's results
Readread_campaign_resultsReads how one collab did: what was delivered, how it performed, and the money and targets beside it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.offerIdRequiredWhich collab to read the results for, exactly as list_campaign_collabs or read_campaign_delivery gave it.
Read the option schedule
Readread_offer_optionsLists every amplification option pre-priced into this campaign's signed offers — free to hold, priced only if the brand exercises it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Read the work on a campaign
Readread_campaign_deliveryReads the submitted work across a campaign: what has come in, which version, and what is waiting on your review.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.
Remove a queued boost
Runs directlyremove_queued_boostTakes one queued boost back off the queue. The piece stays live, nothing was charged for it, and you can queue a different amount instead.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.creatorOptionalA creator by display name, canonical slug, @creator/<slug> mention, or id.pieceOptionalWhich live piece, by its platform or its format — "YouTube", "short", "TikTok video".
Send a piece back with your notes
Asks firstsend_back_with_notesSends a submitted piece back to the creator with the notes your team wrote on it in the screening room. Nothing is sent until you approve it.
Details
campaignOptionalA campaign by title, slug, @campaign/<slug> mention, or id.deliverableIdRequiredWhich promised piece, from read_campaign_delivery.