Givebutter

Learn how to use Givebutter with Composio

Overview

SLUG

GIVEBUTTER

Description

Givebutter is a fundraising platform that offers a free, open, and public API for developers to manage campaigns, track donations, and engage with supporters.

Authentication Details

generic_api_key
stringRequired

Tools

SLUG: GIVEBUTTER_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".

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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.

Action Parameters

cover
object
currency
stringDefaults to USD
description
string
end_at
string
goal
integer
meta
object
slug
string
subtitle
string
title
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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.

Action Parameters

enabled
booleanDefaults to True
events
arrayRequired
name
stringRequired
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_DELETE_CAMPAIGN

Tool to delete a campaign by its id. use after confirming the campaign has no funds raised. example: "delete campaign abc123".

Action Parameters

campaign_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_DELETE_CONTACT

Tool to delete a contact by their id. use after confirming the contact has no associated data (e.g., no transactions or communications). example: "delete contact abc123".

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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".

Action Parameters

fund_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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".

Action Parameters

webhook_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_GET_FUND

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

Action Parameters

fund_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_GET_MEMBERS

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

Action Parameters

campaign_id
stringRequired
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_GET_PAYOUTS

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

Action Parameters

limit
integer
page
integer

Action Response

data
arrayRequired
error
string
links
objectRequired
meta
objectRequired
successful
booleanRequired

SLUG: GIVEBUTTER_GET_PLANS

Tool to retrieve a list of plans associated with your account. use after authentication to fetch recurring donation plans.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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".

Action Parameters

campaign_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_GET_TICKETS

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

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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.

Action Parameters

scope
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_GET_WEBHOOKS

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

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_UPDATE_CAMPAIGN

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

Action Parameters

campaign_id
stringRequired
cover
object
currency
string
description
string
end_at
string
goal
integer
meta
object
slug
string
subtitle
string
title
string
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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.

Action Parameters

address
object
contact_id
stringRequired
custom_fields
array
email
string
first_name
string
last_name
string
phone
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: GIVEBUTTER_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."

Action Parameters

enabled
boolean
events
array
id
stringRequired
name
string
url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired