The Givebutter connector lets your AI agent act in each user's Givebutter account. Each user connects their own Givebutter access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 30 · 20 · 1030 read20 write10 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Givebutter connection
In AgentKit > Connections, create a Givebutter connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'givebutter'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Givebutter:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'givebutter_campaigns_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "givebutter"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Givebutter:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="givebutter_campaigns_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Givebutter credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolgivebutter_campaign_getGet one campaign by ID.Read-onlyGet Campaign
Get one campaign by ID. Returns its type, title, description, goal, amount raised, donors, URL, cover, settings, event details and dates.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
givebutter_campaign_member_getGet one member (fundraiser) of a campaign.Read-onlyGet Campaign Member
Get one member (fundraiser) of a campaign. Returns their name, email, goal, amount raised, donors, team and page URL.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
memberintegerrequired- ID of the campaign member (fundraiser). Example: 45678.
givebutter_campaign_members_listList the members (peer-to-peer fundraisers) of a campaign.Read-onlyList Campaign Members
List the members (peer-to-peer fundraisers) of a campaign. Returns per member their ID, name, email, picture, goal, amount raised, donors and page URL. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_campaign_teams_list for teams.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_campaign_team_getGet one fundraising team of a campaign.Read-onlyGet Campaign Team
Get one fundraising team of a campaign. Returns its name, goal, amount raised, donors, members and page URL.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
teamintegerrequired- ID of the campaign team. Example: 2345.
givebutter_campaign_teams_listList the fundraising teams of a campaign.Read-onlyList Campaign Teams
List the fundraising teams of a campaign. Returns per team its ID, name, logo, goal, amount raised, donors, members count and page URL. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_campaign_members_list for individual fundraisers.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_campaign_tickets_listList the ticket types (items for sale) of an event campaign.Read-onlyList Campaign Ticket Types
List the ticket types (items for sale) of an event campaign. Returns per ticket type its ID, name, price, quantity, sold count and settings. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_tickets_list for issued tickets.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_campaigns_listList the account's fundraising campaigns, optionally only listed or unlisted ones.Read-onlyList Campaigns
List the account's fundraising campaigns, optionally only listed or unlisted ones. Returns per campaign its ID, code, type, title, goal, amount raised, donors, URL, status and dates. Results are paged: data holds the records and meta the current page, last page and total. Use this to find a campaign ID. Use givebutter_campaign_get for one campaign.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
publicstring- Only listed (true) or unlisted (false) campaigns. One of: true, false, 1, 0. Example: true.one of
truefalse10 scopestring- Campaign scope filter, e.g. chapters to include chapter campaigns. Example: chapters.
givebutter_contact_activities_listList the activity timeline of a contact (notes, emails, calls, meetings, donations, tickets, subscriptions), optionally of one type.Read-onlyList Contact Activities
List the activity timeline of a contact (notes, emails, calls, meetings, donations, tickets, subscriptions), optionally of one type. Returns per activity its ID, type, subject, note and date. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
typestring- Only activities of this type. One of: archived, campaign.joined, email, email.subscribed, email.unsubscribed, letter, meeting, note, phone_call, recurring_plan.canceled, recurring_plan.created, recurring_plan.activated, signup_form.submitted, sms, sms.subscribed, sms.unsubscribed, subscription_form.submitted, completed_task, created_task, ticket.issued, transaction.recieved, transaction.succeeded, transaction.acknowledged, transaction.unacknowledged, unarchived, volunteer_activity, soft_credited, tagged, untagged, custom_field.updated, video_message.sent, video_message.deleted. Example: note.one of
archivedcampaign.joinedemailemail.subscribedemail.unsubscribedlettermeetingnotephone_callrecurring_plan.canceledrecurring_plan.createdrecurring_plan.activatedsignup_form.submittedsmssms.subscribedsms.unsubscribedsubscription_form.submittedcompleted_taskcreated_taskticket.issuedtransaction.recievedtransaction.succeededtransaction.acknowledgedtransaction.unacknowledgedunarchivedvolunteer_activitysoft_creditedtaggeduntaggedcustom_field.updatedvideo_message.sentvideo_message.deleted
givebutter_contact_activity_getGet one activity of a contact.Read-onlyGet Contact Activity
Get one activity of a contact. Returns its type, subject, note, date and related records.
Inputs
activityintegerrequired- ID of the contact activity. Example: 55501.
contactintegerrequired- ID of the contact. Example: 9876543.
givebutter_contact_getGet one contact by ID.Read-onlyGet Contact
Get one contact by ID. Returns names, emails, phones, addresses, company, tags, custom fields, subscription flags, contribution totals and dates.
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
givebutter_contacts_listList contacts (donors and supporters), filtered by type, dates, contribution totals, tags, email or name and sorted as asked.Read-onlyList Contacts
List contacts (donors and supporters), filtered by type, dates, contribution totals, tags, email or name and sorted as asked. Returns per contact their ID, names, emails, phones, addresses, tags, totals and dates. Results are paged: data holds the records and meta the current page, last page and total. Use this to find a contact. Use givebutter_contact_get for one contact.
Inputs
created_afterstring- Only contacts created on or after this date. Example: 2026-01-01.
created_beforestring- Only contacts created on or before this date. Example: 2026-12-31.
emailstring- Any email of the contact. Example: jane@example.com.
first_namestring- First name. Example: Jane.
last_namestring- Last name. Example: Doe.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
primary_emailstring- Primary email of the contact. Example: jane@example.com.
sort_bystring- Sort ascending by this field. One of: name_or_company, primary_email, point_of_contact, created_at, total_contributions, recurring_contributions, last_donation_amount. Example: created_at.one of
name_or_companyprimary_emailpoint_of_contactcreated_attotal_contributionsrecurring_contributionslast_donation_amount sort_by_descstring- Sort descending by this field. One of: name_or_company, primary_email, point_of_contact, created_at, total_contributions, recurring_contributions, last_donation_amount. Example: created_at.one of
name_or_companyprimary_emailpoint_of_contactcreated_attotal_contributionsrecurring_contributionslast_donation_amount tagsstring- Comma-separated tag names; returns contacts with these tags. Example: major-donor.
total_contributions_maxnumber- Maximum lifetime contributions. Example: 10000.
total_contributions_minnumber- Minimum lifetime contributions. Example: 100.
typestring- Contact type: individual or company. One of: individual, company. Example: individual.one of
individualcompany updated_afterstring- Only contacts updated on or after this date. Example: 2026-01-01.
updated_beforestring- Only contacts updated on or before this date. Example: 2026-12-31.
givebutter_discount_codes_listList the discount codes of a campaign.Read-onlyList Discount Codes
List the discount codes of a campaign. Returns per code its ID, code, type, amount, uses, active flag, items and validity dates. Results are paged: data holds the records and meta the current page, last page and total. Use this to find a code ID before updating it.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_fund_getGet one fund by ID.Read-onlyGet Fund
Get one fund by ID. Returns its code, name, amount raised and supporters.
Inputs
fundstringrequired- ID of the fund. Example: fund_9xQ2.
givebutter_funds_listList the funds (designations donors can give to).Read-onlyList Funds
List the funds (designations donors can give to). Returns per fund its ID, code, name, amount raised and supporters. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_household_contacts_listList the contacts that belong to a household.Read-onlyList Household Contacts
List the contacts that belong to a household. Returns per contact their ID, names, emails and phones. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
householdintegerrequired- ID of the household. Example: 3344.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_household_getGet one household by ID.Read-onlyGet Household
Get one household by ID. Returns its name, envelope name, note, head contact and members.
Inputs
householdintegerrequired- ID of the household. Example: 3344.
givebutter_households_listList households (groups of contacts such as a family), optionally searched by name or filtered by head contact or member contacts.Read-onlyList Households
List households (groups of contacts such as a family), optionally searched by name or filtered by head contact or member contacts. Returns per household its ID, name, envelope name, head contact and members.
Inputs
contactsstring- Comma-separated contact IDs; households containing them. Example: 9876543.
head_contact_idstring- Only households whose head is this contact ID. Example: 9876543.
pagestring- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
querystring- Text to search household names for. Example: Doe.
givebutter_message_getGet one sent message by ID.Read-onlyGet Message
Get one sent message by ID. Returns its type, subject, body, recipients, status and dates.
Inputs
messageintegerrequired- ID of the message. Example: 77120.
givebutter_messages_listList the email and text messages sent from the account.Read-onlyList Messages
List the email and text messages sent from the account. Returns per message its ID, type, subject, body, recipients count, status and dates. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_payout_getGet one payout by ID.Read-onlyGet Payout
Get one payout by ID. Returns its amount, fee, tip, status, method, campaign and dates.
Inputs
payoutstringrequired- ID of the payout. Example: po_8kL2mN.
givebutter_payouts_listList payouts (transfers of raised funds to the organization's bank account).Read-onlyList Payouts
List payouts (transfers of raised funds to the organization's bank account). Returns per payout its ID, amount, fee, status, method and dates. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_plan_getGet one recurring donation plan by ID.Read-onlyGet Recurring Plan
Get one recurring donation plan by ID. Returns its contact, amount, frequency, status, start and next bill dates and campaign.
Inputs
planstringrequired- ID of the recurring plan. Example: pl_7Hc2.
givebutter_plans_listList recurring donation plans, optionally for some contacts.Read-onlyList Recurring Plans
List recurring donation plans, optionally for some contacts. Returns per plan its ID, contact, amount, frequency, status, next bill date and campaign. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
contactsstring- Comma-separated contact IDs to filter by. Example: 9876543.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_pledge_getGet one pledge by ID.Read-onlyGet Pledge
Get one pledge by ID. Returns its contact, amount, amount paid, schedule, status and campaign.
Inputs
pledgeintegerrequired- ID of the pledge. Example: 4401.
givebutter_pledges_listList pledges (promised future gifts).Read-onlyList Pledges
List pledges (promised future gifts). Returns per pledge its ID, contact, amount, amount paid, status, campaign and dates. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_ticket_getGet one issued ticket by ID.Read-onlyGet Ticket
Get one issued ticket by ID. Returns attendee, ticket type, price, campaign, transaction, check-in status and PDF link.
Inputs
ticketstringrequired- ID of the ticket. Example: tk_5Gh7Jk.
givebutter_tickets_listList issued event tickets across campaigns.Read-onlyList Tickets
List issued event tickets across campaigns. Returns per ticket its ID, number, attendee name and email, ticket type, price, campaign, check-in status and PDF link. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_campaign_tickets_list for the ticket types on sale.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_transaction_getGet one transaction by ID.Read-onlyGet Transaction
Get one transaction by ID. Returns its campaign, contact, amount, fees, method, status, dedication, custom fields, line items and dates.
Inputs
transactionstringrequired- ID of the transaction. Example: tr_3Df9Gh.
givebutter_transactions_listList transactions (donations, ticket purchases and offline gifts), filtered by transaction, created, updated or check-deposit dates, contacts, method or scope, and sorted as asked.Read-onlyList Transactions
List transactions (donations, ticket purchases and offline gifts), filtered by transaction, created, updated or check-deposit dates, contacts, method or scope, and sorted as asked. Returns per transaction its ID, number, campaign, contact, amount, fee, method, status, line items and dates. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_transaction_get for one transaction.
Inputs
check_deposited_afterstring- Only check transactions deposited on or after this date. Example: 2026-01-01.
check_deposited_beforestring- Only check transactions deposited on or before this date. Example: 2026-12-31.
contactsstring- Comma-separated contact IDs to filter by. Example: 9876543.
created_afterstring- Only transactions created on or after this date. Example: 2026-01-01.
created_beforestring- Only transactions created on or before this date. Example: 2026-12-31.
methodstring- Only this payment method, e.g. card, check, cash, ach. Example: card.
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
scopestring- all, benefiting (gifts to this account) or chapters. One of: all, benefiting, chapters. Example: all.one of
allbenefitingchapters sort_bystring- Sort ascending by this field. One of: amount, transacted_at, created_at, contact_name. Example: created_at.one of
amounttransacted_atcreated_atcontact_name sort_by_descstring- Sort descending by this field. One of: amount, transacted_at, created_at, contact_name. Example: created_at.one of
amounttransacted_atcreated_atcontact_name transacted_afterstring- Only transactions made on or after this date. Example: 2026-01-01.
transacted_beforestring- Only transactions made on or before this date. Example: 2026-12-31.
updated_afterstring- Only transactions updated on or after this date. Example: 2026-01-01.
updated_beforestring- Only transactions updated on or before this date. Example: 2026-12-31.
givebutter_webhooks_listList the account's webhooks.Read-onlyList Webhooks
List the account's webhooks. Returns per webhook its ID, name, URL, subscribed events and enabled flag. Results are paged: data holds the records and meta the current page, last page and total.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
per_pageinteger- Results per page, default 20, maximum 100. Example: 20.
givebutter_campaign_createCreate a fundraising campaign (general donation form, collect, peer-to-peer fundraise or event).WriteCreate Campaign
Create a fundraising campaign (general donation form, collect, peer-to-peer fundraise or event). Returns the new campaign with its ID and URL. Use givebutter_campaign_update to publish or change it.
Inputs
titlestringrequired- Title. Example: Spring Gala 2026.
typestringrequired- Campaign type: general (donation form), collect, fundraise (peer-to-peer) or event. One of: general, collect, fundraise, event. Example: general.one of
generalcollectfundraiseevent currencystring- Three-letter currency code. One of: USD. Example: USD.one of
USD descriptionstring- Description. Example: Entry to the spring gala, dinner included.
end_atstring- When the campaign ends, as YYYY-MM-DD HH:MM:SS. Example: 2026-05-31 23:59:59.
goalinteger- Fundraising goal in whole currency units. Example: 50000.
slugstring- URL slug of the campaign page. Example: spring-gala-2026.
subtitlestring- Subtitle. Example: An evening for our community.
timezonestring- IANA time zone of the dates, e.g. America/New_York. Example: America/New_York.
givebutter_campaign_ticket_createCreate a ticket type for an event campaign, with name, price and quantity.WriteCreate Campaign Ticket Type
Create a ticket type for an event campaign, with name, price and quantity. Returns the new ticket type with its ID.
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
namestringrequired- Ticket type name. Example: General Admission.
pricenumberrequired- Ticket price. Example: 25.
activeboolean- Whether the ticket type is on sale. Example: true.
bundle_onlyboolean- Sell only as part of a bundle. Example: false.
descriptionstring- Description. Example: Entry to the spring gala, dinner included.
hide_remainingboolean- Hide the number of tickets left. Example: false.
retail_pricenumber- Fair market value of the ticket, used for tax receipts. Example: 30.
scopestring- Who the ticket is for: registrant (one per person) or event. One of: registrant, event. Example: registrant.one of
registrantevent subtypestring- Ticket delivery: physical, digital or hybrid. One of: physical, digital, hybrid. Example: physical.one of
physicaldigitalhybrid total_quantityinteger- Number of tickets available; leave empty for unlimited. Example: 200.
givebutter_campaign_updateUpdate the fields you pass on a campaign, including publishing it or hiding it from listings.WriteUpdate Campaign
Update the fields you pass on a campaign, including publishing it or hiding it from listings. Returns the updated campaign.
- Idempotent
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
currencystring- Three-letter currency code. One of: USD. Example: USD.one of
USD descriptionstring- Description. Example: Entry to the spring gala, dinner included.
end_atstring- When the campaign ends, as YYYY-MM-DD HH:MM:SS. Example: 2026-05-31 23:59:59.
goalinteger- Fundraising goal in whole currency units. Example: 50000.
publicboolean- Whether the campaign is listed publicly. Example: true.
publishedboolean- Whether the campaign is published (live). Example: true.
slugstring- Slug. Example: spring-gala-2026.
subtitlestring- Subtitle. Example: An evening for our community.
timezonestring- IANA time zone of the dates, e.g. America/New_York. Example: America/New_York.
titlestring- Title. Example: Spring Gala 2026.
typestring- Campaign type. One of: general, collect, fundraise, event. Example: general.one of
generalcollectfundraiseevent
givebutter_contact_activity_createLog an activity on a contact's timeline: an email, meeting, note, phone call, text message, completed task or volunteer activity.WriteLog Contact Activity
Log an activity on a contact's timeline: an email, meeting, note, phone call, text message, completed task or volunteer activity. Returns the new activity with its ID.
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
typestringrequired- Activity type. One of: email, meeting, note, phone_call, sms, completed_task, volunteer_activity. Example: phone_call.one of
emailmeetingnotephone_callsmscompleted_taskvolunteer_activity notestring- Body of the activity. Example: Thanked the donor by phone.
occurred_atstring- When the activity happened, as YYYY-MM-DD HH:MM:SS. Example: 2026-03-10 14:30:00.
subjectstring- Subject or title of the activity. Example: Thank-you call.
timezonestring- IANA time zone of the dates, e.g. America/New_York. Example: America/New_York.
givebutter_contact_createCreate a contact (an individual or a company).WriteCreate Contact
Create a contact (an individual or a company). If a contact with the same email or phone exists it is returned instead, unless force_create is true. Returns the contact with its ID.
Inputs
force_createboolean- Create a new contact even if one with the same email or phone already exists (otherwise the existing contact is returned). Example: false.
givebutter_contact_restoreRestore an archived contact.WriteRestore Contact
Restore an archived contact. Returns the restored contact.
- Idempotent
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
givebutter_contact_updateUpdate the fields you pass on a contact; other fields are unchanged.WriteUpdate Contact
Update the fields you pass on a contact; other fields are unchanged. Emails and phones are added. Returns the updated contact.
- Idempotent
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
biostring- Short biography. Example: Board member since 2020.
company_namestring- Required for company contacts. Optional for individual contacts, which require first_name and last_name instead. Example: Acme Corp.
dobstring- Date of birth, YYYY-MM-DD. Example: 1985-06-15.
email_opt_inboolean- Whether the contact opts in to emails. Example: true.
emailsarray- Email addresses to add, each an object with value, an optional type (such as home or work) and is_primary. Example: [{"value": "jane.doe@example.org", "type": "work", "is_primary": false}]
employerstring- Employer name. Example: Acme Corp.
external_idstring- Your own ID for the record, from another system. Example: crm-1001.
first_namestring- Required for individual contacts. Optional for company contacts, which require company_name instead. Example: Jane.
genderstring- Gender. One of: male, female, other. Example: female.one of
malefemaleother last_namestring- Required for individual contacts. Optional for company contacts, which require company_name instead. Example: Doe.
linkedin_urlstring- LinkedIn profile URL. Example: https://www.linkedin.com/in/janedoe.
middle_namestring- Middle name. Example: Ann.
notestring- Note. Example: Thanked the donor by phone.
phonesarray- Phone numbers to add, each an object with value, an optional type (such as mobile or work) and is_primary. Example: [{"value": "+15555550199", "type": "mobile", "is_primary": false}]
preferred_namestring- Preferred name or nickname. Example: Janie.
prefixstring- Name prefix, e.g. Dr. Example: Dr.
pronounsstring- Pronouns, e.g. she/her. Example: she/her.
sms_opt_inboolean- Whether the contact opts in to text messages. Example: false.
suffixstring- Name suffix, e.g. Jr. Example: Jr.
titlestring- Job title. Example: Director.
typestring- Contact type: individual or company. One of: individual, company. Example: individual.one of
individualcompany website_urlstring- Website URL. Example: https://example.com.
givebutter_discount_code_createCreate a discount code for a campaign's tickets or items, as a percentage or fixed amount off.WriteCreate Discount Code
Create a discount code for a campaign's tickets or items, as a percentage or fixed amount off. Returns the new code with its ID.
Inputs
activebooleanrequired- Whether the code can be used now. Example: true.
amountnumberrequired- Discount amount: a percentage for percentage codes, a currency amount for fixed codes. Example: 10.
campaignintegerrequired- ID of the campaign. Example: 123456.
codestringrequired- The code buyers enter. Example: SPRING10.
typestringrequired- Discount type: percentage or fixed amount. One of: percentage, fixed. Example: percentage.one of
percentagefixed expires_atstring- When the code expires, as YYYY-MM-DD HH:MM:SS. Example: 2026-04-30 23:59:59.
include_futureboolean- Whether the code also applies to items added to the campaign later. Example: false.
itemsarray- IDs of the campaign items (such as tickets) the code applies to; leave empty for all items. Example: ["4567"]
starts_atstring- When the code becomes valid, as YYYY-MM-DD HH:MM:SS. Example: 2026-03-01 00:00:00.
usesnumber- How many times the code can be used in total; leave empty for unlimited. Example: 100.
givebutter_discount_code_updateUpdate a campaign discount code.WriteUpdate Discount Code
Update a campaign discount code. amount is required; other fields you pass are changed. Returns the updated code.
- Idempotent
Inputs
amountnumberrequired- Discount amount: a percentage for percentage codes, a currency amount for fixed codes. Example: 10.
campaignintegerrequired- ID of the campaign. Example: 123456.
discount_codeintegerrequired- ID of the discount code. Example: 789.
activeboolean- Whether the code can be used now. Example: true.
codestring- The code buyers enter. Example: SPRING10.
expires_atstring- When the code expires, as YYYY-MM-DD HH:MM:SS. Example: 2026-04-30 23:59:59.
include_futureboolean- Whether the code also applies to items added to the campaign later. Example: false.
itemsarray- IDs of the campaign items (such as tickets) the code applies to; leave empty for all items. Example: ["4567"]
starts_atstring- When the code becomes valid, as YYYY-MM-DD HH:MM:SS. Example: 2026-03-01 00:00:00.
typestring- Discount type: percentage or fixed amount. One of: percentage, fixed. Example: percentage.one of
percentagefixed usesnumber- How many times the code can be used in total; leave empty for unlimited. Example: 100.
givebutter_fund_createCreate a fund that donors can designate gifts to.WriteCreate Fund
Create a fund that donors can designate gifts to. Returns the new fund with its ID.
Inputs
namestringrequired- Fund name. Example: Scholarship Fund.
codestring- Short fund code used in reports and imports. Example: SCHOLAR.
givebutter_fund_updateRename a fund or change its code.WriteUpdate Fund
Rename a fund or change its code. Returns the updated fund.
- Idempotent
Inputs
fundstringrequired- ID of the fund. Example: fund_9xQ2.
namestringrequired- Fund name. Example: Scholarship Fund.
codestring- Short fund code used in reports and imports. Example: SCHOLAR.
givebutter_household_contact_addAdd a contact to a household.WriteAdd Contact to Household
Add a contact to a household. Returns the household's contact.
Inputs
contact_idintegerrequired- ID of the contact to add. Example: 9876543.
householdintegerrequired- ID of the household. Example: 3344.
givebutter_household_createCreate a household to group contacts, such as a family.WriteCreate Household
Create a household to group contacts, such as a family. Returns the new household with its ID. Use givebutter_household_contact_add to add members.
Inputs
namestringrequired- Household name. Example: Doe Family.
envelope_namestring- Name to print on envelopes. Example: The Doe Family.
head_contact_idinteger- Contact ID of the head of the household. Example: 9876543.
notestring- A note about the household. Example: Thanked the donor by phone.
givebutter_household_updateUpdate the fields you pass on a household.WriteUpdate Household
Update the fields you pass on a household. Returns the updated household.
- Idempotent
Inputs
householdintegerrequired- ID of the household. Example: 3344.
envelope_namestring- Name to print on envelopes. Example: The Doe Family.
head_contact_idinteger- Contact ID of the head of the household. Example: 9876543.
namestring- Household name. Example: Doe Family.
notestring- A note about the household. Example: Thanked the donor by phone.
givebutter_transaction_createRecord an offline gift or payment (cash, check, ACH, stock, in-kind and so on) and link it to a contact, campaign and fund.WriteRecord Offline Transaction
Record an offline gift or payment (cash, check, ACH, stock, in-kind and so on) and link it to a contact, campaign and fund. Returns the new transaction with its ID. This does not charge anyone.
Inputs
amountstringrequired- Gift amount as a decimal string, e.g. 250.00. Example: 250.00.
methodstringrequired- Payment method. One of: ach, card, cash, check, digital_wallet, donor_advised_fund, paypal, venmo, cashapp, terminal, stock, in-kind, property, other, none. Example: check.one of
achcardcashcheckdigital_walletdonor_advised_fundpaypalvenmocashappterminalstockin-kindpropertyothernone transacted_atstringrequired- When the payment was made, as YYYY-MM-DD HH:MM:SS. Example: 2026-03-15 10:00:00.
acknowledged_atstring- When the gift was acknowledged (thank-you sent). Example: 2026-03-16 09:00:00.
address_1string- Street address, line 1. Example: 123 Main St.
anonymousboolean- Hide the donor's name publicly. Example: false.
appeal_codestring- Code of the appeal the gift answers. Example: SPRING26.
campaign_codestring- Code of the campaign to credit. Example: SPRINGGALA.
check_deposited_atstring- Date the check was deposited. Example: 2026-03-20.
check_numberstring- Check number, for check gifts. Example: 1042.
citystring- City. Example: Austin.
companystring- Company name of the donor. Example: Acme Corp.
contact_idinteger- ID of an existing contact; otherwise the name and email fields create or match one. Example: 9876543.
countrystring- Country as a two-letter ISO code. Example: US.
dedication_namestring- Name of the person the gift is dedicated to. Example: John Doe.
dedication_typestring- Dedication: in_memory_of or in_honor_of. One of: in_memory_of, in_honor_of. Example: in_honor_of.one of
in_memory_ofin_honor_of emailstring- Email address. Example: jane@example.com.
external_idstring- Your own ID for the gift. Example: crm-1001.
first_namestring- First name. Example: Jane.
fund_codestring- Code of the fund to designate the gift to. Example: GENERAL.
internal_notestring- Internal note, not shown to the donor. Example: Mailed check from board member.
last_namestring- Last name. Example: Doe.
mark_depositedboolean- Mark the gift as deposited. Example: false.
phonestring- Phone number, ideally in E.164 format. Example: +15555550123.
statestring- State, province or region. Example: TX.
timezonestring- IANA time zone of the dates, e.g. America/New_York. Example: America/New_York.
zipcodestring- ZIP or postal code. Example: 78701.
givebutter_transaction_updateUpdate a transaction's internal note, check details, campaign, team, member, fund, appeal, method or date.WriteUpdate Transaction
Update a transaction's internal note, check details, campaign, team, member, fund, appeal, method or date. Returns the updated transaction.
- Idempotent
Inputs
transactionstringrequired- ID of the transaction. Example: tr_3Df9Gh.
appeal_idstring- ID of the appeal. Example: 6612.
campaign_idstring- ID of the campaign to move the transaction to. Example: 123456.
campaign_member_idstring- ID of the campaign member to credit. Example: 45678.
check_deposited_atstring- Date the check was deposited. Example: 2026-03-20.
check_numberstring- Check number. Example: 1042.
fund_idstring- ID of the fund to designate. Example: fund_9xQ2.
internal_notestring- Internal note, not shown to the donor. Example: Mailed check from board member.
methodstring- Payment method, e.g. check. Example: check.
team_idstring- ID of the campaign team to credit. Example: 2345.
transacted_atstring- When the payment was made, as YYYY-MM-DD HH:MM:SS. Example: 2026-03-15 10:00:00.
givebutter_webhook_createCreate a webhook that posts the chosen events (new campaigns, tickets, successful transactions, contacts, recurring plan changes, refunds) to a URL.WriteCreate Webhook
Create a webhook that posts the chosen events (new campaigns, tickets, successful transactions, contacts, recurring plan changes, refunds) to a URL. Returns the new webhook with its ID and signing secret.
Inputs
urlstringrequired- HTTPS URL that receives the events. Example: https://example.com/givebutter-webhook.
enabledboolean- Whether the webhook is active. Example: true.
eventsarray- Events to send. Example: ["transaction.succeeded"]
namestring- Name for the webhook. Example: CRM sync.
givebutter_campaign_deleteDelete a campaign.DestructiveDelete Campaign
Delete a campaign. Returns nothing on success.
- Idempotent
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
givebutter_campaign_member_deleteRemove a member (fundraiser) from a campaign.DestructiveDelete Campaign Member
Remove a member (fundraiser) from a campaign. Returns nothing on success.
- Idempotent
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
memberintegerrequired- ID of the campaign member (fundraiser). Example: 45678.
givebutter_campaign_team_deleteDelete a fundraising team from a campaign.DestructiveDelete Campaign Team
Delete a fundraising team from a campaign. Returns nothing on success.
- Idempotent
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
teamintegerrequired- ID of the campaign team. Example: 2345.
givebutter_contact_activity_deleteDelete an activity from a contact's timeline.DestructiveDelete Contact Activity
Delete an activity from a contact's timeline. Returns nothing on success.
- Idempotent
Inputs
activityintegerrequired- ID of the contact activity. Example: 55501.
contactintegerrequired- ID of the contact. Example: 9876543.
givebutter_contact_deleteArchive (soft-delete) a contact.DestructiveArchive Contact
Archive (soft-delete) a contact. Returns nothing on success. Use givebutter_contact_restore to bring it back.
- Idempotent
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
givebutter_discount_code_deleteDelete a campaign discount code.DestructiveDelete Discount Code
Delete a campaign discount code. Returns nothing on success.
- Idempotent
Inputs
campaignintegerrequired- ID of the campaign. Example: 123456.
discount_codeintegerrequired- ID of the discount code. Example: 789.
givebutter_fund_deleteDelete a fund.DestructiveDelete Fund
Delete a fund. Returns nothing on success.
- Idempotent
Inputs
fundstringrequired- ID of the fund. Example: fund_9xQ2.
givebutter_household_contact_removeRemove a contact from a household; the contact itself is kept.DestructiveRemove Contact from Household
Remove a contact from a household; the contact itself is kept. Returns nothing on success.
- Idempotent
Inputs
contactintegerrequired- ID of the contact. Example: 9876543.
householdintegerrequired- ID of the household. Example: 3344.
givebutter_household_deleteDelete a household; its contacts are kept.DestructiveDelete Household
Delete a household; its contacts are kept. Returns nothing on success.
- Idempotent
Inputs
householdintegerrequired- ID of the household. Example: 3344.
givebutter_webhook_deleteDelete a webhook.DestructiveDelete Webhook
Delete a webhook. Returns nothing on success.
- Idempotent
Inputs
webhookstringrequired- ID of the webhook. Example: wh_6Tz1.
No tools match.