Givebutter
App · 22 actions
Run your nonprofit's fundraising from workflows: look up and update contacts, create and edit campaigns and funds, read donations, and start a workflow when a new contact or donation arrives.
Actions
| Action | What it does |
|---|---|
| Archive contact | Archive a contact so it drops out of your lists. |
| Create campaign | Create a campaign. |
| Create contact | Add a contact. |
| Create fund | Create a fund that gifts can be directed to. |
| Create webhook | Have Givebutter send an event, such as a successful donation, to an https address. |
| Delete campaign | Delete a campaign. |
| Delete fund | Delete a fund. |
| Delete webhook | Delete a webhook so Givebutter stops sending to it. |
| Get campaign | Get one campaign with its goal, amount raised and address. |
| Get contact | Get one contact with their emails, phones, addresses, tags and giving totals. |
| Get fund | Get one fund with what it has raised. |
| Get transaction | Get one donation or payment with its donor, amounts and campaign. |
| Get webhook | Get one webhook with its address, event and state. |
| List campaigns | List your campaigns (donation forms, fundraisers and events), newest first, with their goal, amount raised and address. |
| List contacts | List your contacts, newest first. |
| List funds | List your funds, the causes gifts can be directed to. |
| List transactions | List donations and other payments, newest first, with who gave, how much and to which campaign. |
| List webhooks | List the webhooks that send Givebutter events to an address. |
| Restore contact | Bring an archived contact back. |
| Update campaign | Change a campaign's title, subtitle, description, goal or end time. |
| Update contact | Change a contact. |
| Update fund | Rename a fund or change its code. |
Archive contact
Archive a contact so it drops out of your lists. 'Restore contact' brings it back.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'List contacts' or an earlier step.
Outputs
archivedtrue/false- Always true once done
contact_idnumber- The contact archived
Example output
{
"archived": true,
"contact_id": 49191414
}Create campaign
Create a campaign. It starts unpublished: review and publish it in Givebutter when it is ready.
Inputs
- Title
titletextRequired - The campaign's title.
- Type
campaign_typetext - What kind of campaign. Defaults to a donation form.One of:
collect(Donation form),fundraise(Fundraiser),event. - Subtitle
subtitletext - A line under the title.
- Description
descriptiontext - What the campaign is for, shown on its page.
- Goal
goalnumber - The fundraising goal, as a whole number such as 5000.At least 1.
- Ends at
end_atdate and time - When the campaign ends.
Outputs
campaignobject- The campaign
Example output
{
"campaign": {
"code": "A769LN",
"created_at": "2026-11-13T19:02:54+00:00",
"currency": "USD",
"description": "Help us reach our goal.",
"donors": 0,
"end_at": null,
"goal": 5000,
"id": 790816,
"public": false,
"raised": 0,
"slug": "spring-appeal-a769ln",
"status": "unpublished",
"subtitle": null,
"timezone": "UTC",
"title": "Spring Appeal",
"type": "collect",
"updated_at": "2026-11-13T19:02:54+00:00",
"url": "https://givebutter.com/spring-appeal-a769ln"
}
}Create contact
Add a contact. If Givebutter already has someone with the same email or phone, it merges them into that contact.
Inputs
- First name
first_nametextRequired - The contact's first name.
- Last name
last_nametextRequired - The contact's last name.
- Email
emailtext - An email address.
- Email type
email_typetext - Whether the email is personal or work. Defaults to personal.One of:
personal(Personal (default)),work. - Phone
phonetext - A phone number, ideally with its country code, such as +14155550123.
- Phone type
phone_typetext - Whether the number is a home or work one. Defaults to home.One of:
home(Home (default)),work. - Company
companytext - The company they work for.
- Job title
titletext - Their job title.
- Date of birth
date_of_birthdate - Their date of birth.
- Note
notetext - A private note on the contact.
- Your own ID
external_idtext - An id from your own system, to match the contact later.
- Address line 1
address_line_1text - Street address. Needs the other address fields below to be useful.
- Address line 2
address_line_2text - Apartment, suite or similar.
- City
citytext - City.
- State
statetext - State or region.
- Postal code
postal_codetext - ZIP or postal code.
- Country
countrytext - Country, such as US.
- Tags
tagstext - Tags to put on the contact, separated by commas.
Outputs
contactobject- The contact
Example output
{
"contact": {
"addresses": [],
"archived_at": null,
"company": null,
"contact_since": "2026-11-13",
"created_at": "2026-11-13T18:23:08+00:00",
"dob": null,
"email_opt_in": true,
"emails": [
{
"type": "personal",
"value": "jo@example.com"
}
],
"external_id": null,
"first_name": "Jo",
"id": 49191414,
"last_donation_amount": null,
"last_name": "Bloggs",
"note": null,
"phones": [],
"primary_email": "jo@example.com",
"primary_phone": null,
"sms_opt_in": false,
"stats": {
"recurring_contributions": 0,
"total_contributions": 0
},
"tags": [
"donor"
],
"title": null,
"type": "individual",
"updated_at": "2026-11-13T18:23:08+00:00"
}
}Create fund
Create a fund that gifts can be directed to.
Inputs
- Name
nametextRequired - The fund's name.
- Code
codetext - A short code for the fund. Givebutter makes one if blank.
Outputs
fundobject- The fund
Example output
{
"fund": {
"code": "GEN",
"created_at": "2026-11-13T19:03:07+00:00",
"id": "Tq23g1wOMwbRiOmO",
"name": "General fund",
"raised": 0,
"supporters": 0,
"updated_at": "2026-11-13T19:03:07+00:00"
}
}Create webhook
Have Givebutter send an event, such as a successful donation, to an https address. The result includes the secret each delivery is signed with.
Inputs
- Address
urltextRequired - The https:// address to send events to.
- Event
eventtextRequired - Which event to send.One of:
transaction.succeeded(A donation or payment succeeds),contact.created(A contact is created),campaign.created(A campaign is created),campaign.updated(A campaign is changed),ticket.created(A ticket is created),plan.created(A recurring plan is created),plan.updated(A recurring plan is changed),plan.canceled(A recurring plan is canceled),plan.resumed(A recurring plan is resumed). - Name
nametext - A name to find it by. Defaults to one made from the event.
Outputs
webhookobject- The webhook
Example output
{
"webhook": {
"created_at": "2026-11-13T19:03:08+00:00",
"enabled": true,
"events": [
"transaction.succeeded"
],
"id": "64728cdc-e553-4e66-a3af-da8be24cf77d",
"last_status": null,
"last_used_at": null,
"name": "Lodol transaction.succeeded",
"signature": "signing-secret-example",
"updated_at": "2026-11-13T19:03:08+00:00",
"url": "https://example.com/hooks/givebutter"
}
}Delete campaign
Delete a campaign. Givebutter refuses if the campaign has already raised money.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its id from an earlier step.
Outputs
campaign_idnumber- The campaign deleted
deletedtrue/false- Always true once deleted
Example output
{
"campaign_id": 790816,
"deleted": true
}Delete fund
Delete a fund.
Inputs
- Fund
fund_idtextRequired - The fund. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
fund_idtext- The fund deleted
Example output
{
"deleted": true,
"fund_id": "Tq23g1wOMwbRiOmO"
}Delete webhook
Delete a webhook so Givebutter stops sending to it.
Inputs
- Webhook ID
webhook_idtextRequired - The webhook's id, from 'List webhooks' or 'Create webhook'.
Outputs
deletedtrue/false- Always true once deleted
webhook_idtext- The webhook deleted
Example output
{
"deleted": true,
"webhook_id": "64728cdc-e553-4e66-a3af-da8be24cf77d"
}Get campaign
Get one campaign with its goal, amount raised and address.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its id from an earlier step.
Outputs
campaignobject- The campaign
Example output
{
"campaign": {
"code": "A769LN",
"created_at": "2026-11-13T19:02:54+00:00",
"currency": "USD",
"description": "Help us reach our goal.",
"donors": 0,
"end_at": null,
"goal": 5000,
"id": 790816,
"public": false,
"raised": 0,
"slug": "spring-appeal-a769ln",
"status": "unpublished",
"subtitle": null,
"timezone": "UTC",
"title": "Spring Appeal",
"type": "collect",
"updated_at": "2026-11-13T19:02:54+00:00",
"url": "https://givebutter.com/spring-appeal-a769ln"
}
}Get contact
Get one contact with their emails, phones, addresses, tags and giving totals.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'List contacts' or an earlier step.
Outputs
contactobject- The contact
Example output
{
"contact": {
"addresses": [],
"archived_at": null,
"company": null,
"contact_since": "2026-11-13",
"created_at": "2026-11-13T18:23:08+00:00",
"dob": null,
"email_opt_in": true,
"emails": [
{
"type": "personal",
"value": "jo@example.com"
}
],
"external_id": null,
"first_name": "Jo",
"id": 49191414,
"last_donation_amount": null,
"last_name": "Bloggs",
"note": null,
"phones": [],
"primary_email": "jo@example.com",
"primary_phone": null,
"sms_opt_in": false,
"stats": {
"recurring_contributions": 0,
"total_contributions": 0
},
"tags": [
"donor"
],
"title": null,
"type": "individual",
"updated_at": "2026-11-13T18:23:08+00:00"
}
}Get fund
Get one fund with what it has raised.
Inputs
- Fund
fund_idtextRequired - The fund. Pick one, or give its id from an earlier step.
Outputs
fundobject- The fund
Example output
{
"fund": {
"code": "GEN",
"created_at": "2026-11-13T19:03:07+00:00",
"id": "Tq23g1wOMwbRiOmO",
"name": "General fund",
"raised": 0,
"supporters": 0,
"updated_at": "2026-11-13T19:03:07+00:00"
}
}Get transaction
Get one donation or payment with its donor, amounts and campaign.
Inputs
- Transaction ID
transaction_idtextRequired - The transaction's id, from 'List transactions' or an earlier step.
Outputs
transactionobject- The transaction
Example output
{
"transaction": {
"amount": 25,
"campaign_code": "A769LN",
"campaign_id": 790816,
"campaign_title": "Spring Appeal",
"company": null,
"contact_id": 49191414,
"created_at": "2026-11-13T19:03:41+00:00",
"currency": "USD",
"donated": 25,
"email": "jo@example.com",
"fee": 1.03,
"first_name": "Jo",
"fund_id": null,
"id": "fOWbxcjbDAVnuvLp",
"internal_note": null,
"is_recurring": false,
"last_name": "Bloggs",
"method": "card",
"number": "6446470296",
"payout": 23.97,
"phone": null,
"status": "succeeded",
"transacted_at": "2026-11-13T12:00:00+00:00"
}
}Get webhook
Get one webhook with its address, event and state.
Inputs
- Webhook ID
webhook_idtextRequired - The webhook's id, from 'List webhooks' or 'Create webhook'.
Outputs
webhookobject- The webhook
Example output
{
"webhook": {
"created_at": "2026-11-13T19:03:08+00:00",
"enabled": true,
"events": [
"transaction.succeeded"
],
"id": "64728cdc-e553-4e66-a3af-da8be24cf77d",
"last_status": null,
"last_used_at": null,
"name": "Lodol transaction.succeeded",
"signature": "signing-secret-example",
"updated_at": "2026-11-13T19:03:08+00:00",
"url": "https://example.com/hooks/givebutter"
}
}List campaigns
List your campaigns (donation forms, fundraisers and events), newest first, with their goal, amount raised and address.
Inputs
- Page
pagenumber - Which page of results, starting at 1. Defaults to the first.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 100. Givebutter's default is 20.From 1 to 100.
Outputs
campaignslist- The campaigns
countnumber- How many are on this page
has_moretrue/false- Whether another page follows
pagenumber- This page's number
totalnumber- How many there are in all
Example output
{
"campaigns": [
{
"code": "A769LN",
"created_at": "2026-11-13T19:02:54+00:00",
"currency": "USD",
"description": "Help us reach our goal.",
"donors": 0,
"end_at": null,
"goal": 5000,
"id": 790816,
"public": false,
"raised": 0,
"slug": "spring-appeal-a769ln",
"status": "unpublished",
"subtitle": null,
"timezone": "UTC",
"title": "Spring Appeal",
"type": "collect",
"updated_at": "2026-11-13T19:02:54+00:00",
"url": "https://givebutter.com/spring-appeal-a769ln"
}
],
"count": 1,
"has_more": false,
"page": 1,
"total": 1
}List contacts
List your contacts, newest first. Give an email to find one person, or ask for the archived contacts.
Inputs
- Email
emailtext - Only the contact with this email address.
- Archived contacts
archivedtrue/false - List the archived contacts instead.
- Page
pagenumber - Which page of results, starting at 1. Defaults to the first.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 100. Givebutter's default is 20.From 1 to 100.
Outputs
contactslist- The contacts
countnumber- How many are on this page
has_moretrue/false- Whether another page follows
pagenumber- This page's number
totalnumber- How many there are in all
Example output
{
"contacts": [
{
"addresses": [],
"archived_at": null,
"company": null,
"contact_since": "2026-11-13",
"created_at": "2026-11-13T18:23:08+00:00",
"dob": null,
"email_opt_in": true,
"emails": [
{
"type": "personal",
"value": "jo@example.com"
}
],
"external_id": null,
"first_name": "Jo",
"id": 49191414,
"last_donation_amount": null,
"last_name": "Bloggs",
"note": null,
"phones": [],
"primary_email": "jo@example.com",
"primary_phone": null,
"sms_opt_in": false,
"stats": {
"recurring_contributions": 0,
"total_contributions": 0
},
"tags": [
"donor"
],
"title": null,
"type": "individual",
"updated_at": "2026-11-13T18:23:08+00:00"
}
],
"count": 1,
"has_more": false,
"page": 1,
"total": 1
}List funds
List your funds, the causes gifts can be directed to.
Inputs
- Page
pagenumber - Which page of results, starting at 1. Defaults to the first.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 100. Givebutter's default is 20.From 1 to 100.
Outputs
countnumber- How many are on this page
fundslist- The funds
has_moretrue/false- Whether another page follows
pagenumber- This page's number
totalnumber- How many there are in all
Example output
{
"count": 1,
"funds": [
{
"code": "GEN",
"created_at": "2026-11-13T19:03:07+00:00",
"id": "Tq23g1wOMwbRiOmO",
"name": "General fund",
"raised": 0,
"supporters": 0,
"updated_at": "2026-11-13T19:03:07+00:00"
}
],
"has_more": false,
"page": 1,
"total": 1
}List transactions
List donations and other payments, newest first, with who gave, how much and to which campaign.
Inputs
- Page
pagenumber - Which page of results, starting at 1. Defaults to the first.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 100. Givebutter's default is 20.From 1 to 100.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether another page follows
pagenumber- This page's number
totalnumber- How many there are in all
transactionslist- The transactions
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"total": 1,
"transactions": [
{
"amount": 25,
"campaign_code": "A769LN",
"campaign_id": 790816,
"campaign_title": "Spring Appeal",
"company": null,
"contact_id": 49191414,
"created_at": "2026-11-13T19:03:41+00:00",
"currency": "USD",
"donated": 25,
"email": "jo@example.com",
"fee": 1.03,
"first_name": "Jo",
"fund_id": null,
"id": "fOWbxcjbDAVnuvLp",
"internal_note": null,
"is_recurring": false,
"last_name": "Bloggs",
"method": "card",
"number": "6446470296",
"payout": 23.97,
"phone": null,
"status": "succeeded",
"transacted_at": "2026-11-13T12:00:00+00:00"
}
]
}List webhooks
List the webhooks that send Givebutter events to an address.
Inputs
- Page
pagenumber - Which page of results, starting at 1. Defaults to the first.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 100. Givebutter's default is 20.From 1 to 100.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether another page follows
pagenumber- This page's number
totalnumber- How many there are in all
webhookslist- The webhooks
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"total": 1,
"webhooks": [
{
"created_at": "2026-11-13T19:03:08+00:00",
"enabled": true,
"events": [
"transaction.succeeded"
],
"id": "64728cdc-e553-4e66-a3af-da8be24cf77d",
"last_status": null,
"last_used_at": null,
"name": "Lodol transaction.succeeded",
"signature": "signing-secret-example",
"updated_at": "2026-11-13T19:03:08+00:00",
"url": "https://example.com/hooks/givebutter"
}
]
}Restore contact
Bring an archived contact back.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'List contacts' or an earlier step.
Outputs
contactobject- The contact
Example output
{
"contact": {
"addresses": [],
"archived_at": null,
"company": null,
"contact_since": "2026-11-13",
"created_at": "2026-11-13T18:23:08+00:00",
"dob": null,
"email_opt_in": true,
"emails": [
{
"type": "personal",
"value": "jo@example.com"
}
],
"external_id": null,
"first_name": "Jo",
"id": 49191414,
"last_donation_amount": null,
"last_name": "Bloggs",
"note": null,
"phones": [],
"primary_email": "jo@example.com",
"primary_phone": null,
"sms_opt_in": false,
"stats": {
"recurring_contributions": 0,
"total_contributions": 0
},
"tags": [
"donor"
],
"title": null,
"type": "individual",
"updated_at": "2026-11-13T18:23:08+00:00"
}
}Update campaign
Change a campaign's title, subtitle, description, goal or end time. Only the fields given change.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its id from an earlier step.
- Title
titletext - A new title. Leave blank to keep it.
- Subtitle
subtitletext - A line under the title.
- Description
descriptiontext - What the campaign is for, shown on its page.
- Goal
goalnumber - The fundraising goal, as a whole number such as 5000.At least 1.
- Ends at
end_atdate and time - When the campaign ends.
Outputs
campaignobject- The campaign
Example output
{
"campaign": {
"code": "A769LN",
"created_at": "2026-11-13T19:02:54+00:00",
"currency": "USD",
"description": "Help us reach our goal.",
"donors": 0,
"end_at": null,
"goal": 7500,
"id": 790816,
"public": false,
"raised": 0,
"slug": "spring-appeal-a769ln",
"status": "unpublished",
"subtitle": null,
"timezone": "UTC",
"title": "Spring Appeal",
"type": "collect",
"updated_at": "2026-11-13T19:02:54+00:00",
"url": "https://givebutter.com/spring-appeal-a769ln"
}
}Update contact
Change a contact. An email or phone is added beside the ones they have, tags are added or removed, and anything else given replaces what was there.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'List contacts' or an earlier step.
- First name
first_nametext - A new first name. Leave blank to keep it.
- Last name
last_nametext - A new last name. Leave blank to keep it.
- Email
emailtext - An email address.
- Email type
email_typetext - Whether the email is personal or work. Defaults to personal.One of:
personal(Personal (default)),work. - Phone
phonetext - A phone number, ideally with its country code, such as +14155550123.
- Phone type
phone_typetext - Whether the number is a home or work one. Defaults to home.One of:
home(Home (default)),work. - Company
companytext - The company they work for.
- Job title
titletext - Their job title.
- Date of birth
date_of_birthdate - Their date of birth.
- Note
notetext - A private note on the contact.
- Your own ID
external_idtext - An id from your own system, to match the contact later.
- Address line 1
address_line_1text - Street address. Needs the other address fields below to be useful.
- Address line 2
address_line_2text - Apartment, suite or similar.
- City
citytext - City.
- State
statetext - State or region.
- Postal code
postal_codetext - ZIP or postal code.
- Country
countrytext - Country, such as US.
- Tags to add
add_tagstext - Tags to add, separated by commas. The contact's other tags stay.
- Tags to remove
remove_tagstext - Tags to take off, separated by commas.
Outputs
contactobject- The contact
Example output
{
"contact": {
"addresses": [],
"archived_at": null,
"company": null,
"contact_since": "2026-11-13",
"created_at": "2026-11-13T18:23:08+00:00",
"dob": null,
"email_opt_in": true,
"emails": [
{
"type": "personal",
"value": "jo@example.com"
}
],
"external_id": null,
"first_name": "Jo",
"id": 49191414,
"last_donation_amount": null,
"last_name": "Bloggs",
"note": "Met at the gala.",
"phones": [],
"primary_email": "jo@example.com",
"primary_phone": null,
"sms_opt_in": false,
"stats": {
"recurring_contributions": 0,
"total_contributions": 0
},
"tags": [
"donor"
],
"title": null,
"type": "individual",
"updated_at": "2026-11-13T18:23:08+00:00"
}
}Update fund
Rename a fund or change its code.
Inputs
- Fund
fund_idtextRequired - The fund. Pick one, or give its id from an earlier step.
- Name
nametext - A new name. Leave blank to keep it.
- Code
codetext - A new code. Leave blank to keep it.
Outputs
fundobject- The fund
Example output
{
"fund": {
"code": "GEN",
"created_at": "2026-11-13T19:03:07+00:00",
"id": "Tq23g1wOMwbRiOmO",
"name": "Annual fund",
"raised": 0,
"supporters": 0,
"updated_at": "2026-11-13T19:03:07+00:00"
}
}