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

ActionWhat it does
Archive contactArchive a contact so it drops out of your lists.
Create campaignCreate a campaign.
Create contactAdd a contact.
Create fundCreate a fund that gifts can be directed to.
Create webhookHave Givebutter send an event, such as a successful donation, to an https address.
Delete campaignDelete a campaign.
Delete fundDelete a fund.
Delete webhookDelete a webhook so Givebutter stops sending to it.
Get campaignGet one campaign with its goal, amount raised and address.
Get contactGet one contact with their emails, phones, addresses, tags and giving totals.
Get fundGet one fund with what it has raised.
Get transactionGet one donation or payment with its donor, amounts and campaign.
Get webhookGet one webhook with its address, event and state.
List campaignsList your campaigns (donation forms, fundraisers and events), newest first, with their goal, amount raised and address.
List contactsList your contacts, newest first.
List fundsList your funds, the causes gifts can be directed to.
List transactionsList donations and other payments, newest first, with who gave, how much and to which campaign.
List webhooksList the webhooks that send Givebutter events to an address.
Restore contactBring an archived contact back.
Update campaignChange a campaign's title, subtitle, description, goal or end time.
Update contactChange a contact.
Update fundRename 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 IDcontact_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

TitletitletextRequired
The campaign's title.
Typecampaign_typetext
What kind of campaign. Defaults to a donation form.One of: collect (Donation form), fundraise (Fundraiser), event.
Subtitlesubtitletext
A line under the title.
Descriptiondescriptiontext
What the campaign is for, shown on its page.
Goalgoalnumber
The fundraising goal, as a whole number such as 5000.At least 1.
Ends atend_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 namefirst_nametextRequired
The contact's first name.
Last namelast_nametextRequired
The contact's last name.
Emailemailtext
An email address.
Email typeemail_typetext
Whether the email is personal or work. Defaults to personal.One of: personal (Personal (default)), work.
Phonephonetext
A phone number, ideally with its country code, such as +14155550123.
Phone typephone_typetext
Whether the number is a home or work one. Defaults to home.One of: home (Home (default)), work.
Companycompanytext
The company they work for.
Job titletitletext
Their job title.
Date of birthdate_of_birthdate
Their date of birth.
Notenotetext
A private note on the contact.
Your own IDexternal_idtext
An id from your own system, to match the contact later.
Address line 1address_line_1text
Street address. Needs the other address fields below to be useful.
Address line 2address_line_2text
Apartment, suite or similar.
Citycitytext
City.
Statestatetext
State or region.
Postal codepostal_codetext
ZIP or postal code.
Countrycountrytext
Country, such as US.
Tagstagstext
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

NamenametextRequired
The fund's name.
Codecodetext
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

AddressurltextRequired
The https:// address to send events to.
EventeventtextRequired
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).
Namenametext
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

Campaigncampaign_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

Fundfund_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 IDwebhook_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

Campaigncampaign_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 IDcontact_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

Fundfund_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 IDtransaction_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 IDwebhook_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

Pagepagenumber
Which page of results, starting at 1. Defaults to the first.At least 1.
Page sizeper_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

Emailemailtext
Only the contact with this email address.
Archived contactsarchivedtrue/false
List the archived contacts instead.
Pagepagenumber
Which page of results, starting at 1. Defaults to the first.At least 1.
Page sizeper_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

Pagepagenumber
Which page of results, starting at 1. Defaults to the first.At least 1.
Page sizeper_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

Pagepagenumber
Which page of results, starting at 1. Defaults to the first.At least 1.
Page sizeper_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

Pagepagenumber
Which page of results, starting at 1. Defaults to the first.At least 1.
Page sizeper_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 IDcontact_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

Campaigncampaign_idtextRequired
The campaign. Pick one, or give its id from an earlier step.
Titletitletext
A new title. Leave blank to keep it.
Subtitlesubtitletext
A line under the title.
Descriptiondescriptiontext
What the campaign is for, shown on its page.
Goalgoalnumber
The fundraising goal, as a whole number such as 5000.At least 1.
Ends atend_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 IDcontact_idtextRequired
The contact's id, from 'List contacts' or an earlier step.
First namefirst_nametext
A new first name. Leave blank to keep it.
Last namelast_nametext
A new last name. Leave blank to keep it.
Emailemailtext
An email address.
Email typeemail_typetext
Whether the email is personal or work. Defaults to personal.One of: personal (Personal (default)), work.
Phonephonetext
A phone number, ideally with its country code, such as +14155550123.
Phone typephone_typetext
Whether the number is a home or work one. Defaults to home.One of: home (Home (default)), work.
Companycompanytext
The company they work for.
Job titletitletext
Their job title.
Date of birthdate_of_birthdate
Their date of birth.
Notenotetext
A private note on the contact.
Your own IDexternal_idtext
An id from your own system, to match the contact later.
Address line 1address_line_1text
Street address. Needs the other address fields below to be useful.
Address line 2address_line_2text
Apartment, suite or similar.
Citycitytext
City.
Statestatetext
State or region.
Postal codepostal_codetext
ZIP or postal code.
Countrycountrytext
Country, such as US.
Tags to addadd_tagstext
Tags to add, separated by commas. The contact's other tags stay.
Tags to removeremove_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

Fundfund_idtextRequired
The fund. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave blank to keep it.
Codecodetext
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"
  }
}

On this page