# Givebutter

> 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.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/givebutter

## Actions

### Archive contact

Archive a contact so it drops out of your lists. 'Restore contact' brings it back.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.

**Outputs**

- `archived` (true/false): Always true once done
- `contact_id` (number): The contact archived

**Example output**

```json
{
  "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 (`title`, text, required): The campaign's title.
- Type (`campaign_type`, text): What kind of campaign. Defaults to a donation form. One of: `collect` (Donation form), `fundraise` (Fundraiser), `event`.
- Subtitle (`subtitle`, text): A line under the title.
- Description (`description`, text): What the campaign is for, shown on its page.
- Goal (`goal`, number): The fundraising goal, as a whole number such as 5000. At least 1.
- Ends at (`end_at`, date and time): When the campaign ends.

**Outputs**

- `campaign` (object): The campaign

**Example output**

```json
{
  "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_name`, text, required): The contact's first name.
- Last name (`last_name`, text, required): The contact's last name.
- Email (`email`, text): An email address.
- Email type (`email_type`, text): Whether the email is personal or work. Defaults to personal. One of: `personal` (Personal (default)), `work`.
- Phone (`phone`, text): A phone number, ideally with its country code, such as +14155550123.
- Phone type (`phone_type`, text): Whether the number is a home or work one. Defaults to home. One of: `home` (Home (default)), `work`.
- Company (`company`, text): The company they work for.
- Job title (`title`, text): Their job title.
- Date of birth (`date_of_birth`, date): Their date of birth.
- Note (`note`, text): A private note on the contact.
- Your own ID (`external_id`, text): An id from your own system, to match the contact later.
- Address line 1 (`address_line_1`, text): Street address. Needs the other address fields below to be useful.
- Address line 2 (`address_line_2`, text): Apartment, suite or similar.
- City (`city`, text): City.
- State (`state`, text): State or region.
- Postal code (`postal_code`, text): ZIP or postal code.
- Country (`country`, text): Country, such as US.
- Tags (`tags`, text): Tags to put on the contact, separated by commas.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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 (`name`, text, required): The fund's name.
- Code (`code`, text): A short code for the fund. Givebutter makes one if blank.

**Outputs**

- `fund` (object): The fund

**Example output**

```json
{
  "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 (`url`, text, required): The https:// address to send events to.
- Event (`event`, text, required): 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 (`name`, text): A name to find it by. Defaults to one made from the event.

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "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_id`, text, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign_id` (number): The campaign deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "campaign_id": 790816,
  "deleted": true
}
```

### Delete fund

Delete a fund.

**Inputs**

- Fund (`fund_id`, text, required): The fund. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `fund_id` (text): The fund deleted

**Example output**

```json
{
  "deleted": true,
  "fund_id": "Tq23g1wOMwbRiOmO"
}
```

### Delete webhook

Delete a webhook so Givebutter stops sending to it.

**Inputs**

- Webhook ID (`webhook_id`, text, required): The webhook's id, from 'List webhooks' or 'Create webhook'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `webhook_id` (text): The webhook deleted

**Example output**

```json
{
  "deleted": true,
  "webhook_id": "64728cdc-e553-4e66-a3af-da8be24cf77d"
}
```

### Get campaign

Get one campaign with its goal, amount raised and address.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign` (object): The campaign

**Example output**

```json
{
  "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_id`, text, required): The contact's id, from 'List contacts' or an earlier step.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The fund. Pick one, or give its id from an earlier step.

**Outputs**

- `fund` (object): The fund

**Example output**

```json
{
  "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_id`, text, required): The transaction's id, from 'List transactions' or an earlier step.

**Outputs**

- `transaction` (object): The transaction

**Example output**

```json
{
  "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_id`, text, required): The webhook's id, from 'List webhooks' or 'Create webhook'.

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "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 (`page`, number): Which page of results, starting at 1. Defaults to the first. At least 1.
- Page size (`per_page`, number): How many to return per page, 1 to 100. Givebutter's default is 20. From 1 to 100.

**Outputs**

- `campaigns` (list): The campaigns
- `count` (number): How many are on this page
- `has_more` (true/false): Whether another page follows
- `page` (number): This page's number
- `total` (number): How many there are in all

**Example output**

```json
{
  "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 (`email`, text): Only the contact with this email address.
- Archived contacts (`archived`, true/false): List the archived contacts instead.
- Page (`page`, number): Which page of results, starting at 1. Defaults to the first. At least 1.
- Page size (`per_page`, number): How many to return per page, 1 to 100. Givebutter's default is 20. From 1 to 100.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many are on this page
- `has_more` (true/false): Whether another page follows
- `page` (number): This page's number
- `total` (number): How many there are in all

**Example output**

```json
{
  "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 (`page`, number): Which page of results, starting at 1. Defaults to the first. At least 1.
- Page size (`per_page`, number): How many to return per page, 1 to 100. Givebutter's default is 20. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `funds` (list): The funds
- `has_more` (true/false): Whether another page follows
- `page` (number): This page's number
- `total` (number): How many there are in all

**Example output**

```json
{
  "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 (`page`, number): Which page of results, starting at 1. Defaults to the first. At least 1.
- Page size (`per_page`, number): How many to return per page, 1 to 100. Givebutter's default is 20. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether another page follows
- `page` (number): This page's number
- `total` (number): How many there are in all
- `transactions` (list): The transactions

**Example output**

```json
{
  "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 (`page`, number): Which page of results, starting at 1. Defaults to the first. At least 1.
- Page size (`per_page`, number): How many to return per page, 1 to 100. Givebutter's default is 20. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether another page follows
- `page` (number): This page's number
- `total` (number): How many there are in all
- `webhooks` (list): The webhooks

**Example output**

```json
{
  "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_id`, text, required): The contact's id, from 'List contacts' or an earlier step.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The campaign. Pick one, or give its id from an earlier step.
- Title (`title`, text): A new title. Leave blank to keep it.
- Subtitle (`subtitle`, text): A line under the title.
- Description (`description`, text): What the campaign is for, shown on its page.
- Goal (`goal`, number): The fundraising goal, as a whole number such as 5000. At least 1.
- Ends at (`end_at`, date and time): When the campaign ends.

**Outputs**

- `campaign` (object): The campaign

**Example output**

```json
{
  "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_id`, text, required): The contact's id, from 'List contacts' or an earlier step.
- First name (`first_name`, text): A new first name. Leave blank to keep it.
- Last name (`last_name`, text): A new last name. Leave blank to keep it.
- Email (`email`, text): An email address.
- Email type (`email_type`, text): Whether the email is personal or work. Defaults to personal. One of: `personal` (Personal (default)), `work`.
- Phone (`phone`, text): A phone number, ideally with its country code, such as +14155550123.
- Phone type (`phone_type`, text): Whether the number is a home or work one. Defaults to home. One of: `home` (Home (default)), `work`.
- Company (`company`, text): The company they work for.
- Job title (`title`, text): Their job title.
- Date of birth (`date_of_birth`, date): Their date of birth.
- Note (`note`, text): A private note on the contact.
- Your own ID (`external_id`, text): An id from your own system, to match the contact later.
- Address line 1 (`address_line_1`, text): Street address. Needs the other address fields below to be useful.
- Address line 2 (`address_line_2`, text): Apartment, suite or similar.
- City (`city`, text): City.
- State (`state`, text): State or region.
- Postal code (`postal_code`, text): ZIP or postal code.
- Country (`country`, text): Country, such as US.
- Tags to add (`add_tags`, text): Tags to add, separated by commas. The contact's other tags stay.
- Tags to remove (`remove_tags`, text): Tags to take off, separated by commas.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The fund. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave blank to keep it.
- Code (`code`, text): A new code. Leave blank to keep it.

**Outputs**

- `fund` (object): The fund

**Example output**

```json
{
  "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"
  }
}
```
