# Givebutter

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

- **Category:** fundraising
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 59
- **Triggers:** 0
- **Slug:** `GIVEBUTTER`
- **Version:** 20260316_00

## Tools

### Add Contact Tags

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of tags to add to the contact. Each tag must be 64 characters or less. |
| `contact` | integer | Yes | The contact ID to add tags to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Household Contact

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `household` | integer | Yes | The household ID to add the contact to. |
| `contact_id` | integer | Yes | The contact ID to add to the household. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Archive Contact

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to archive. The contact must have no associated data like transactions, recurring donations, auction bids, tickets, or communications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `goal` | integer | No | Campaign goal amount in cents (e.g., $1000 -> 100000). |
| `meta` | object | No | SEO meta tags for the campaign page. |
| `slug` | string | No | Unique slug for the campaign; auto-generated if omitted. |
| `type` | string ("general" | "collect" | "fundraise" | "event") | Yes | Type of the campaign. |
| `cover` | object | No | Banner image settings; include only when providing a cover. |
| `title` | string | Yes | Primary title of the campaign. |
| `end_at` | string | No | UTC datetime string when the campaign ends. |
| `currency` | string | No | Currency code; only USD is currently supported. |
| `subtitle` | string | No | Optional subtitle displayed under the title. |
| `description` | string | No | HTML content for the campaign description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign Ticket

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the ticket (max 255 characters). |
| `price` | number | Yes | Price of the ticket in USD. |
| `scope` | string ("registrant" | "event") | Yes | Scope of the ticket: 'registrant' (per person) or 'event' (per order). |
| `active` | boolean | No | Whether the ticket is active and available for purchase. |
| `bundles` | array | No | List of bundle IDs this ticket is associated with. |
| `subtype` | string ("physical" | "digital" | "hybrid") | Yes | Subtype of the ticket: physical, digital, or hybrid. |
| `campaign` | integer | Yes | The campaign ID where the ticket will be created. |
| `pictures` | array | No | List of picture URLs to display for the ticket. |
| `bundle_only` | boolean | No | Whether this ticket can only be purchased as part of a bundle. |
| `description` | string | No | Description of the ticket (max 5000 characters). |
| `retail_price` | number | No | Original retail price for comparison (e.g., to show discounts). |
| `custom_fields` | array | No | List of custom field IDs to collect from ticket buyers. |
| `hide_remaining` | boolean | No | Whether to hide the remaining ticket count from buyers. |
| `total_quantity` | integer | No | Total quantity of tickets available. If not specified, unlimited tickets. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dob` | string | No | Date of birth in YYYY-MM-DD format. |
| `note` | string | No | Additional notes about the contact. |
| `title` | string | No | Job title or position. |
| `emails` | array | No | List of email addresses with types. |
| `gender` | string | No | Gender of the contact. |
| `phones` | array | No | List of phone numbers with types. |
| `prefix` | string | No | Name prefix (e.g., 'Mr.', 'Ms.', 'Dr.'). |
| `suffix` | string | No | Name suffix (e.g., 'Jr.', 'Sr.', 'III'). |
| `company` | string | No | Company or organization name. |
| `employer` | string | No | Employer name. |
| `pronouns` | string | No | Preferred pronouns (e.g., 'he/him', 'she/her', 'they/them'). |
| `addresses` | array | No | List of addresses for the contact. |
| `last_name` | string | Yes | Last name of the contact. |
| `first_name` | string | Yes | First name of the contact. |
| `tiktok_url` | string | No | TikTok profile URL. |
| `external_id` | string | No | External identifier from another system. |
| `middle_name` | string | No | Middle name of the contact. |
| `twitter_url` | string | No | Twitter profile URL. |
| `website_url` | string | No | Personal or company website URL. |
| `company_name` | string | No | Full company name. |
| `facebook_url` | string | No | Facebook profile URL. |
| `linkedin_url` | string | No | LinkedIn profile URL. |
| `custom_fields` | array | No | List of custom field values (id and value pairs). |
| `primary_email` | string | No | Primary email address of the contact. |
| `primary_phone` | string | No | Primary phone number of the contact. |
| `preferred_name` | string | No | Preferred name or nickname. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact Activity

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | Yes | The note content for the activity. |
| `type` | string | Yes | The type of activity (e.g., 'note'). |
| `contact` | integer | Yes | The contact ID to create the activity for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Discount Code

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | Yes | The discount code string that users will enter. Must be unique within the campaign and no more than 255 characters. |
| `type` | string ("percentage" | "fixed") | Yes | Type of discount: 'percentage' for a percentage-based discount (e.g., 10% off), or 'fixed' for a fixed amount discount (e.g., $10 off). |
| `uses` | integer | No | Maximum number of times the discount code can be used. If not provided, there is no usage limit. |
| `items` | array | No | List of item IDs that the discount code applies to. If not provided, the code applies to all items in the campaign. |
| `active` | boolean | Yes | Whether the discount code is active and can be used immediately. |
| `amount` | number | Yes | Discount amount. For 'percentage' type, this is the percentage (e.g., 10 for 10% off). For 'fixed' type, this is the amount in cents (e.g., 1000 for $10.00 off). |
| `campaign` | integer | Yes | The campaign ID to create the discount code for. |
| `starts_at` | string | No | UTC datetime string when the discount code becomes active (ISO-8601 format). If not provided, the code is active immediately. |
| `expires_at` | string | No | UTC datetime string when the discount code expires (ISO-8601 format). If not provided, the code will not expire. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Fund

**Slug:** `GIVEBUTTER_CREATE_FUND`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | Optional unique code for the fund. |
| `name` | string | Yes | Name of the fund to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Household

**Slug:** `GIVEBUTTER_CREATE_HOUSEHOLD`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the household (required). |
| `note` | string | No | Additional notes about the household (optional). |
| `envelope_name` | string | No | Envelope name for the household (optional). |
| `head_contact_id` | integer | No | ID of the contact designated as the head of the household (optional). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Transaction

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | number | Yes | Transaction amount in dollars (e.g., 25.00 for $25). |
| `contact_id` | integer | Yes | ID of the contact who made this transaction. Must be a valid integer referencing an existing contact. |
| `campaign_code` | string | No | Campaign code to credit this transaction to. Required if campaign_title is not provided. Either campaign_code or campaign_title must be specified. |
| `transacted_at` | string | Yes | UTC datetime when the transaction occurred in ISO 8601 format (e.g., '2026-02-13T15:30:00Z'). Must be a date before now. |
| `campaign_title` | string | No | Campaign title to credit this transaction to. Required if campaign_code is not provided. Either campaign_code or campaign_title must be specified. |
| `payment_method` | string | Yes | Payment method used for the transaction. Common values include 'cash', 'check', 'card', 'paypal', 'venmo', 'ach', etc. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The HTTPS endpoint URL that will receive webhook payloads. |
| `name` | string | Yes | A friendly name for the webhook subscription. |
| `events` | array | Yes | List of event types that will trigger this webhook subscription. |
| `enabled` | boolean | No | Whether the webhook is active immediately upon creation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Campaign

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Unique identifier of the campaign to delete. Cannot delete if the campaign has any funds raised. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact Activity

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | integer | Yes | The contact ID |
| `activity_id` | integer | Yes | The activity ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Discount Code

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | integer | Yes | The campaign ID that the discount code belongs to. |
| `discount_code` | integer | Yes | The discount code ID to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Fund

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fund_id` | string | Yes | Unique identifier of the fund to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Household

**Slug:** `GIVEBUTTER_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".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `household_id` | integer | Yes | Unique identifier of the household to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | string | Yes | Campaign ID or code to retrieve. Can be numeric ID or campaign slug/code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign Ticket

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | integer | Yes | The campaign ID |
| `ticketId` | integer | Yes | The ticket ID to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact

**Slug:** `GIVEBUTTER_GET_CONTACT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | integer | Yes | Unique identifier of the contact to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact Activity

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact` | integer | Yes | The contact ID |
| `activity` | integer | Yes | The activity ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Discount Code

**Slug:** `GIVEBUTTER_GET_DISCOUNT_CODE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | integer | Yes | The campaign ID |
| `discount_code` | integer | Yes | The discount code ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fund

**Slug:** `GIVEBUTTER_GET_FUND`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fund_id` | string | Yes | Unique identifier of the fund to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Household

**Slug:** `GIVEBUTTER_GET_HOUSEHOLD`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `household` | integer | Yes | The household ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Members

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `campaign_id` | string | Yes | Unique identifier of the campaign to retrieve members from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Payouts

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1. |
| `limit` | integer | No | Number of payouts to return per page, must be >= 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Plans

**Slug:** `GIVEBUTTER_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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Teams

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Unique identifier of the campaign whose teams to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tickets

**Slug:** `GIVEBUTTER_GET_TICKETS`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transactions

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | string ("account" | "beneficiary" | "chapter") | No | Scope of transactions to retrieve: 'account' (default), 'beneficiary', or 'chapter'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `GIVEBUTTER_GET_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook` | string | Yes | The unique identifier of the webhook to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook Activity

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook` | string | Yes | The webhook ID to retrieve the activity from. |
| `activity` | string | Yes | The activity ID to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhooks

**Slug:** `GIVEBUTTER_GET_WEBHOOKS`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `GIVEBUTTER_LIST_CAMPAIGNS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | string | No | Optional scope parameter to filter campaigns. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaign Tickets

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | integer | Yes | The campaign ID to retrieve tickets from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Contact Activities

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("archived" | "campaign.joined" | "email" | "email.subscribed" | "email.unsubscribed" | "letter" | "meeting" | "note" | "phone_call" | "recurring_plan.canceled" | "recurring_plan.created" | "recurring_plan.activated" | "signup_form.submitted" | "sms" | "sms.subscribed" | "sms.unsubscribed" | "subscription_form.submitted" | "completed_task" | "ticket.issued" | "transaction.recieved" | "transaction.succeeded" | "transaction.acknowledged" | "transaction.unacknowledged" | "unarchived" | "volunteer_activity" | "soft_credited") | No | Enum for activity types |
| `contact` | integer | Yes | The contact ID to retrieve activities for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Contacts

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | string | No | Filter contacts by tags (comma-separated). |
| `type` | string ("individual" | "company") | No | Contact type enumeration |
| `sortBy` | string ("name_or_company" | "primary_email" | "point_of_contact" | "created_at" | "total_contributions" | "recurring_contributions" | "last_donation_amount") | No | Sort by field enumeration |
| `sortByDesc` | string ("name_or_company" | "primary_email" | "point_of_contact" | "created_at" | "total_contributions" | "recurring_contributions" | "last_donation_amount") | No | Sort by field enumeration |
| `createdAfter` | string | No | Filter contacts created after this date (ISO 8601 format). |
| `updatedAfter` | string | No | Filter contacts updated after this date (ISO 8601 format). |
| `createdBefore` | string | No | Filter contacts created before this date (ISO 8601 format). |
| `updatedBefore` | string | No | Filter contacts updated before this date (ISO 8601 format). |
| `totalContributionsMax` | number | No | Filter contacts with total contributions less than or equal to this amount. |
| `totalContributionsMin` | number | No | Filter contacts with total contributions greater than or equal to this amount. |
| `recurringContributionsMax` | number | No | Filter contacts with recurring contributions less than or equal to this amount. |
| `recurringContributionsMin` | number | No | Filter contacts with recurring contributions greater than or equal to this amount. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Discount Codes

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | integer | Yes | The campaign ID to retrieve discount codes for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Funds

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). Defaults to page 1 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Household Contacts

**Slug:** `GIVEBUTTER_LIST_HOUSEHOLD_CONTACTS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `household` | integer | Yes | The household ID to retrieve contacts for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Households

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | string | No | Page number for pagination. Defaults to 1 if not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Messages

**Slug:** `GIVEBUTTER_LIST_MESSAGES`

Tool to retrieve a list of all messages. Use when you need to list messages sent through your Givebutter account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pledges

**Slug:** `GIVEBUTTER_LIST_PLEDGES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). Each page returns up to 20 results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhook Activities

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook` | string | Yes | The webhook ID to list activities for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Contact Tags

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of tag names to remove from the contact. Each tag must be 64 characters or less. |
| `contact` | integer | Yes | The contact ID from which to remove tags. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Contact

**Slug:** `GIVEBUTTER_RESTORE_CONTACT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact` | integer | Yes | The contact ID to restore from deleted state. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sync Contact Tags

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of tag names to sync for this contact. Replaces all existing tags with the specified tags. Each tag must be 64 characters or less. |
| `contact` | integer | Yes | The contact ID to sync tags for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Campaign

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `goal` | integer | No | Campaign goal amount in cents (e.g., $10.00 -> 1000). |
| `meta` | object | No | SEO meta tags for the campaign page. |
| `slug` | string | No | Unique slug for the campaign; auto-generated if omitted. |
| `type` | string ("general" | "collect" | "fundraise" | "event") | No | Type of the campaign. |
| `cover` | object | No | Banner image settings; include only when updating the cover. |
| `title` | string | No | Primary title of the campaign. |
| `end_at` | string | No | UTC datetime string when the campaign ends (e.g., '2024-12-31T23:59:59Z'). |
| `currency` | string | No | Currency code; only USD is currently supported. |
| `subtitle` | string | No | Optional subtitle displayed under the title. |
| `campaign_id` | string | Yes | Unique identifier of the campaign to update. |
| `description` | string | No | HTML content for the campaign description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Campaign (PUT)

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `goal` | integer | No | Campaign goal amount in cents (e.g., $10.00 -> 1000). |
| `meta` | object | No | SEO meta tags for the campaign page. |
| `slug` | string | No | Unique slug for the campaign; auto-generated if omitted. |
| `type` | string ("general" | "collect" | "fundraise" | "event") | No | Type of the campaign. |
| `cover` | object | No | Banner image settings; include only when updating the cover. |
| `title` | string | No | Primary title of the campaign. |
| `end_at` | string | No | UTC datetime string when the campaign ends (e.g., '2024-12-31T23:59:59Z'). |
| `campaign` | integer | Yes | The campaign ID to update. |
| `currency` | string | No | Currency code; only USD is currently supported. |
| `subtitle` | string | No | Optional subtitle displayed under the title. |
| `description` | string | No | HTML content for the campaign description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address of the contact. |
| `phone` | string | No | Phone number of the contact. |
| `address` | object | No | Address details to update |
| `last_name` | string | Yes | Last name of the contact (required by the API). |
| `contact_id` | string | Yes | ID of the contact to update. |
| `first_name` | string | Yes | First name of the contact (required by the API). |
| `custom_fields` | array | No | List of custom field updates (id and new value). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact Activity

**Slug:** `GIVEBUTTER_UPDATE_CONTACT_ACTIVITY`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | The note content for the activity. |
| `type` | string | No | The type of activity (e.g., 'note', 'email', 'phone_call', 'meeting', 'sms', 'completed_task', 'volunteer_activity'). |
| `contact` | integer | Yes | The contact ID. |
| `subject` | string | No | The subject of the activity (not required for note events). |
| `activity` | integer | Yes | The activity ID. |
| `occurred_at` | string | No | When the activity occurred (ISO 8601 format). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact (PUT)

**Slug:** `GIVEBUTTER_UPDATE_CONTACT_PUT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dob` | string | No | Date of birth in YYYY-MM-DD format |
| `note` | string | No | Notes about the contact |
| `title` | string | No | Job title |
| `emails` | array | No | List of email addresses |
| `gender` | string | No | Gender of the contact |
| `phones` | array | No | List of phone numbers |
| `prefix` | string | No | Name prefix (e.g., Mr., Mrs., Dr.) |
| `suffix` | string | No | Name suffix (e.g., Jr., Sr.) |
| `contact` | integer | Yes | The contact ID to update |
| `employer` | string | No | Employer name |
| `pronouns` | string | No | Preferred pronouns |
| `addresses` | array | No | List of addresses |
| `last_name` | string | Yes | Last name of the contact (required by API) |
| `first_name` | string | Yes | First name of the contact (required by API) |
| `tiktok_url` | string | No | TikTok profile URL |
| `middle_name` | string | No | Middle name of the contact |
| `twitter_url` | string | No | Twitter profile URL |
| `website_url` | string | No | Website URL |
| `facebook_url` | string | No | Facebook profile URL |
| `linkedin_url` | string | No | LinkedIn profile URL |
| `preferred_name` | string | No | Preferred name of the contact |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Discount Code

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | The discount code string that users will enter. |
| `type` | string ("percentage" | "fixed") | No | Discount code type |
| `uses` | number | No | Maximum number of times this discount code can be used. If null, unlimited uses. |
| `items` | array | No | List of item IDs that this discount code applies to. If null or empty, applies to all items. |
| `active` | boolean | No | Whether the discount code is active and can be used. |
| `amount` | number | Yes | The discount amount. For percentage type, this is a value between 1-100. For fixed type, this represents the discount amount in cents (e.g., 1500 for $15.00). |
| `campaign` | integer | Yes | The campaign ID to update the discount code for. |
| `starts_at` | string | No | UTC datetime string when the discount code becomes active (ISO 8601 format). |
| `expires_at` | string | No | UTC datetime string when the discount code expires (ISO 8601 format). |
| `discount_code` | integer | Yes | The discount code ID to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Fund

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | Optional code for the fund. Can be null. |
| `name` | string | No | Name of the fund. Required if updating the fund name. |
| `fund_id` | string | Yes | Unique identifier (fid) of the fund to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Household

**Slug:** `GIVEBUTTER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the household. |
| `note` | string | No | Additional notes about the household. |
| `household_id` | integer | Yes | Unique identifier of the household to update. |
| `envelope_name` | string | No | Envelope name for the household. |
| `head_contact_id` | integer | No | ID of the contact who is the head of the household. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the webhook to update |
| `url` | string | Yes | The HTTPS endpoint URL that will receive webhook payloads. Required by the API. |
| `name` | string | No | New friendly name for the webhook subscription. |
| `events` | array | Yes | List of event types that will trigger this webhook subscription. Required by the API. Available: campaign.created, campaign.updated, ticket.created, transaction.succeeded, contact.created, plan.canceled, plan.created, plan.resumed, plan.updated |
| `enabled` | boolean | No | Whether the webhook is active (true) or disabled (false). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook (PUT)

**Slug:** `GIVEBUTTER_UPDATE_WEBHOOK_PUT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The HTTPS endpoint URL that will receive webhook payloads |
| `name` | string | No | Optional friendly name for the webhook |
| `events` | array | Yes | List of event types that will trigger this webhook. Available: campaign.created, campaign.updated, ticket.created, transaction.succeeded, contact.created, plan.canceled, plan.created, plan.paused, plan.resumed, plan.updated |
| `enabled` | boolean | No | Whether the webhook is active (true) or disabled (false) |
| `webhook` | string | Yes | The webhook ID to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |