app_create_campaign
ChatGPTThe campaign presets card's Create draft button: makes a draft campaign with the preset's goal, end date, suggested amounts and starter story. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_discard_campaign_draft
ChatGPTThe editor's Discard draft: drops the saved draft edits of a live campaign. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_end_campaign
ChatGPTThe results card's End campaign button, pressed after its inline confirm: ends the campaign for good; it stops taking gifts. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_get_campaign_editor
ChatGPTThe editor's refresh: the campaign's page, draft included. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_photo_upload_link
ChatGPTThe photo card's Open upload link: a single-use link, good for 15 minutes, to upload the campaign's cover on the site. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_publish_campaign
ChatGPTThe results card's Publish button: puts a draft campaign live, or sends a live campaign's saved draft edits. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_save_campaign_edit
ChatGPTThe editor's save: a live campaign keeps the change as a draft until it is published; a draft campaign is written through. Only the card calls this tool, when the operator presses its button; never call it from the chat.
app_set_campaign_photo
ChatGPTThe photo card's Set as cover: uploads the dropped photo as the campaign's cover. Only the card calls this tool, when the operator presses its button; never call it from the chat.
create_campaign
ChatGPTCreates a new draft campaign with the given title. Donors cannot see it until it is published.
create_form
ChatGPTCreates a donation form. The name is required. Other fields match the shape get_form returns. Each call makes a new form, so after an unclear answer check with list_forms before calling again.
create_photo_upload_link
ChatGPTReturns a single-use link, good for 15 minutes, for adding a campaign's hero photo. The operator opens the link and chooses a JPEG, PNG or WebP of at most 4 MB; expires_at says when the link stops working. This connector does not upload the file. An ended campaign takes no new photo. The uploaded photo becomes the campaign's hero: read the campaign again with get_campaign before editing its blocks.
discard_campaign_draft
ChatGPTDrops the edits saved as a draft of a live campaign, so they never go live; the live campaign stays as donors see it. The dropped edits can't be brought back, so check with the operator first. get_campaign shows the draft under pendingDraft; send its revision, and a draft saved since is kept.
end_campaign
ChatGPTEnds a campaign for good. It stops taking gifts. Donors see this immediately, so the operator confirms it in the chat first.
get_block_catalog
ChatGPTLists every block type a page can hold, with what it is for and its JSON Schema. For sites that edit pages as blocks.
get_campaign
ChatGPTReads one campaign: settings, status, public link, and its page. The page is its content (title, story, photos, gift tiers, questions) and the design the site picked from it on sites with get_content_catalog, or its blocks on sites with get_block_catalog. For the amount raised, use get_results.
get_donation_page
ChatGPTReads the site's main donation page and its public link. The page is its content on sites with get_content_catalog, where only its heading can be edited, or its blocks on sites with get_block_catalog.
get_donor
ChatGPTReads one donor and a page of the gifts they have given.
get_form
ChatGPTReads one donation form in full.
get_profile
ChatGPTReturns the connected Better Giving account: a stable id for it and the nonprofit's name.
get_results
ChatGPTTotals raised, gift count, donor count and per-campaign totals, optionally for one campaign or a date range.
list_campaigns
ChatGPTLists the site's campaigns with their status, public link, and id. For the amount raised, use get_results.
list_donations
ChatGPTLists gifts. Optionally limited to one campaign or a date range.
list_donors
ChatGPTLists donors with their totals. q matches names and emails. Includes each donor's id.
list_forms
ChatGPTLists the site's donation forms (suggested amounts, currency, monthly giving), including each form's id. The list includes the donation page's form and each campaign's form; a campaign's form carries that campaign's campaign_id, and any other form has campaign_id null.
list_nonprofits
ChatGPTLists the nonprofits this person is an admin of on Better Giving, with each one's id, name and logo, and which one this connection is for (current is true on that row). Takes no arguments.
list_recurring_gifts
ChatGPTLists recurring gifts. This connector cannot change a monthly gift.
publish_campaign
ChatGPTPuts a draft campaign live at its public link. The first publish requires gifts_go_to: ask the operator where the gifts go, then send a program id, or null for the general fund. Donors see this immediately, so the operator confirms it in the chat first.
recommend_campaign_presets
ChatGPTRecommends a new campaign's goal, suggested amounts, run length (endDays, days from publish to the end date) and theme from the nonprofit's ended campaigns and its gifts, each with a sentence of evidence. With little history, each is the theme's starting point and basedOnHistory is false. Use the values as create_campaign's preset, with end_date endDays after today.
update_campaign_blocks
ChatGPTEdits the content of a campaign's page, such as its title, story, hero photo, and goal bar. Each block follows a schema from get_block_catalog. get_campaign returns the current content; send every block the page should keep. For sites that edit pages as blocks. A hero photo is one uploaded for this campaign through create_photo_upload_link, as get_campaign shows it, or null.
update_campaign_settings
ChatGPTSets a campaign's goal or end date. A field left out stays as it is, and null clears it. Page content goes through update_campaign_blocks.
update_form
ChatGPTChanges a donation form. Only the fields sent are changed, in the shape get_form returns; send the updated_at get_form returned, so a change made since is refused rather than overwritten. On a live form, a change donors would see needs confirm set to true, and only after the operator agrees.