Givebutter

These are the Givebutter actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Archive Contact

  Tool to archive a contact by their ID. Use after ensuring the contact has no associated data (e.g., no transactions or communications). Example: "Archive contact abc123".

• Create Campaign

  Tool to create a new campaign. Use when you have title, description, goal, and type ready, after confirming your Givebutter account is authenticated.

• Create Contact

  Tool to create a new contact in Givebutter. Use when you need to add a new contact with first name, last name, and optionally email, phone, and other details.

• Create Contact Activity

  Tool to create a contact activity (e.g., note). Use when you need to log an activity for a contact. Requires contact ID and activity details.

• Create Transaction

  Tool to create a new transaction for a campaign. Use when you need to record a donation or payment, typically for offline transactions like cash or check payments.

• Get Campaign

  Tool to retrieve details for a specific campaign by its ID or code. Use when you need to fetch campaign information, check status, or get fundraising progress.

• Get Contact

  Tool to retrieve details of a specific contact by ID. Use after confirming the contact ID is valid.

• List Campaigns

  Tool to retrieve a paginated list of campaigns for the authenticated account. Use when you need to list all campaigns.

• List Contact Activities

  Tool to retrieve all activities for a specific contact. Use when you need to view the activity history of a contact, optionally filtered by activity type.

• List Contacts

  Tool to retrieve a paginated list of contacts from your Givebutter account. Use when you need to list all contacts with optional filtering by type, date ranges, contribution amounts, tags, or sorting preferences.

• List Funds

  Tool to list all funds in your Givebutter account. Returns paginated results with up to 20 funds per page. Use when you need to retrieve multiple funds or browse all available funds.

• List Households

  Tool to retrieve a list of all households in your account. Use when you need to view or manage household groups and their associated contacts.

• Add Contact Tags

  Tool to add tags to a contact by contact ID. Use when you need to categorize or label contacts with specific tags.

• Add Household Contact

  Tool to add a contact to a household. Use when you have both a household ID and contact ID to associate them together.

• Create Campaign Ticket

  Tool to create a campaign ticket for events or fundraisers. Use when you need to add ticket options to a campaign with pricing and inventory details.

• Create Discount Code

  Tool to create a discount code for a campaign. Use when you need to provide promotional pricing or discounts for campaign items.

• Create Fund

  Tool to create a new fund. Use when you need to create a fund with a name and optional code.

• Create Household

  Tool to create a new household in Givebutter. Use when you need to group related contacts under a single household entity.

• Create Webhook

  Tool to create a new webhook subscription. Use when you need to receive real-time notifications programmatically after confirming your endpoint can validate Givebutter's signing secret.

• Delete Campaign

  Tool to delete a campaign by its ID. Use after confirming the campaign has no funds raised. Example: "Delete campaign abc123".

• Delete Contact Activity

  Tool to delete a contact activity by contact ID and activity ID. Use when you need to remove a specific activity from a contact's record.

• Delete Discount Code

  Tool to delete a discount code from a campaign. Use when you need to remove a discount code after confirming it exists.

• Delete Fund

  Tool to delete a fund by its ID. Use when you need to remove a fund after confirming it exists. Example: "Delete fund fund_abc123".

• Delete Household

  Tool to delete a household by its ID. Use after confirming the household exists and has no associated data. Example: "Delete household 1007067".

• Delete Webhook

  Tool to delete a webhook by its ID. Use when you need to remove an obsolete webhook after confirming no further events are needed. Example: "Delete webhook abc123".

• Get Campaign Ticket

  Tool to retrieve a specific campaign ticket by campaign ID and ticket ID. Use when you need details about a specific ticket item within a campaign.

• Get Contact Activity

  Tool to retrieve a specific contact activity by contact ID and activity ID. Use when you need detailed information about a particular activity for a contact.

• Get Discount Code

  Tool to retrieve details of a specific discount code for a campaign. Use when you need to view discount code information.

• Get Fund

  Tool to retrieve details of a specific fund by its ID. Use after confirming the fund ID is valid.

• Get Household

  Tool to retrieve details of a specific household by its ID. Use when you need information about a household including its contacts.

• Get Members

  Tool to retrieve a paginated list of members for a given campaign. Use when you need to list or process campaign members.

• Get Payouts

  Tool to retrieve a list of payouts associated with your account. Use when you need to list withdrawal transactions after authentication.

• Get Plans

  Tool to retrieve a list of plans associated with your account. Use after authentication to fetch recurring donation plans. Returns only plans scoped to the authenticated account; cross-account retrieval is not supported. An empty array is a valid response indicating no recurring plans exist. If paginated, iterate all pages to retrieve the full plan set.

• Get Teams

  Tool to retrieve a list of teams for a specific campaign. Use after creating or updating a campaign when you need to list fundraising teams. Example: "Get teams for campaign camp123".

• Get Tickets

  Tool to retrieve a list of tickets. Use when you need to list all tickets for your account after authentication.

• Get Transactions

  Tool to retrieve a list of transactions associated with your account. Use when you need to list all donations and payments, optionally filtered by scope.

• Get Webhook

  Tool to retrieve a specific webhook by its ID. Use when you need details about a single webhook subscription.

• Get Webhook Activity

  Tool to retrieve a specific webhook activity by its ID. Use when you need detailed information about a single webhook delivery event.

• Get Webhooks

  Tool to retrieve all webhooks configured for your account. Use after obtaining valid authentication.

• List Campaign Tickets

  Tool to retrieve a list of all campaign tickets for a specific campaign. Use when you need to list tickets available for a campaign.

• List Discount Codes

  Tool to list all discount codes for a campaign. Use when you need to retrieve all active and inactive discount codes associated with a specific campaign.

• List Household Contacts

  Tool to retrieve all contacts associated with a household. Use when you need to list contacts for a specific household ID.

• List Messages

  Tool to retrieve a paginated list of messages. Use when you need to list messages sent through your Givebutter account. Returns paginated results; use the page parameter to navigate through pages.

• List Pledges

  Tool to retrieve a paginated list of all pledges. Use when you need to list pledges with optional pagination support.

• List Webhook Activities

  Tool to list all webhook activities for a specific webhook. Use when you need to retrieve activity logs for a webhook subscription.

• Remove Contact Tags

  Tool to remove tags from a contact in Givebutter. Use when you need to disassociate specific tags from a contact record. Requires the contact ID and a list of tag names to remove.

• Restore Contact

  Tool to restore a deleted contact by contact ID. Use when you need to recover a contact that was previously deleted.

• Sync Contact Tags

  Tool to sync tags for a contact. Replaces all existing tags with the specified tags. Use when you need to update the complete tag list for a contact.

• Update Campaign

  Tool to update an existing campaign's details by its ID. Use when you need to modify campaign attributes after creation.

• Update Campaign (PUT)

  Tool to update a campaign using PUT method. Use when you need to update campaign details like title, description, goal, or other attributes.

• Update Contact

  Tool to update an existing contact's details by contact ID. Use when modifying contact information after confirming the contact_id. Only provided fields will be updated.

• Update Contact (PUT)

  Tool to update a contact using PUT method. Use when you need to update contact information by contact ID.

• Update Contact Activity

  Tool to update a contact activity by contact ID and activity ID. Use when modifying an existing contact activity record.

• Update Discount Code

  Tool to update an existing discount code for a campaign. Use when you need to modify discount code details such as amount, expiration, or usage limits.

• Update Fund

  Tool to update a fund's details by its ID. Use when you need to modify fund attributes such as name or code.

• Update Household

  Tool to update an existing household's details by its ID. Use when you need to modify household information after confirming the household_id.

• Update Webhook

  Tool to update an existing webhook subscription's details. Use when you need to modify a webhook's name, URL, trigger events, or enabled state after confirming its ID. Example: "Update webhook wh_1234567890 to point to https://example.com/hook, enable transaction.succeeded only."

• Update Webhook (PUT)

  Tool to update a webhook using PUT method (full replacement). Use when you need to completely replace a webhook's configuration.