Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Givebutter

Scalekit connector
Open markdown

The Givebutter connector lets your AI agent act in each user's Givebutter account. Each user connects their own Givebutter access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
30 · 20 · 1030 read20 write10 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Givebutter connection

    In AgentKit > Connections, create a Givebutter connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'givebutter'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Givebutter:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'givebutter_campaigns_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Givebutter credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • givebutter_campaign_getGet one campaign by ID.Read-only

    Get Campaign

    Get one campaign by ID. Returns its type, title, description, goal, amount raised, donors, URL, cover, settings, event details and dates.

    Inputs

    campaignintegerrequired
    ID of the campaign. Example: 123456.
  • givebutter_campaign_member_getGet one member (fundraiser) of a campaign.Read-only

    Get Campaign Member

    Get one member (fundraiser) of a campaign. Returns their name, email, goal, amount raised, donors, team and page URL.

    Inputs

    campaignintegerrequired
    ID of the campaign. Example: 123456.
    memberintegerrequired
    ID of the campaign member (fundraiser). Example: 45678.
  • givebutter_campaign_members_listList the members (peer-to-peer fundraisers) of a campaign.Read-only

    List Campaign Members

    List the members (peer-to-peer fundraisers) of a campaign. Returns per member their ID, name, email, picture, goal, amount raised, donors and page URL. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_campaign_teams_list for teams.

    Inputs

    campaignintegerrequired
    ID of the campaign. Example: 123456.
    pageinteger
    Page number, starting at 1. Example: 1.
    per_pageinteger
    Results per page, default 20, maximum 100. Example: 20.
  • givebutter_campaign_team_getGet one fundraising team of a campaign.Read-only

    Get Campaign Team

    Get one fundraising team of a campaign. Returns its name, goal, amount raised, donors, members and page URL.

    Inputs

    campaignintegerrequired
    ID of the campaign. Example: 123456.
    teamintegerrequired
    ID of the campaign team. Example: 2345.
  • givebutter_campaign_teams_listList the fundraising teams of a campaign.Read-only

    List Campaign Teams

    List the fundraising teams of a campaign. Returns per team its ID, name, logo, goal, amount raised, donors, members count and page URL. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_campaign_members_list for individual fundraisers.

    Inputs

    campaignintegerrequired
    ID of the campaign. Example: 123456.
    pageinteger
    Page number, starting at 1. Example: 1.
    per_pageinteger
    Results per page, default 20, maximum 100. Example: 20.
  • givebutter_campaign_tickets_listList the ticket types (items for sale) of an event campaign.Read-only

    List Campaign Ticket Types

    List the ticket types (items for sale) of an event campaign. Returns per ticket type its ID, name, price, quantity, sold count and settings. Results are paged: data holds the records and meta the current page, last page and total. Use givebutter_tickets_list for issued tickets.

    Inputs

    campaignintegerrequired
    ID of the campaign. Example: 123456.
    pageinteger
    Page number, starting at 1. Example: 1.
    per_pageinteger
    Results per page, default 20, maximum 100. Example: 20.
  • givebutter_campaigns_listList the account's fundraising campaigns, optionally only listed or unlisted ones.Read-only

    List Campaigns

    List the account's fundraising campaigns, optionally only listed or unlisted ones. Returns per campaign its ID, code, type, title, goal, amount raised, donors, URL, status and dates. Results are paged: data holds the records and meta the current page, last page and total. Use this to find a campaign ID. Use givebutter_campaign_get for one campaign.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1.
    per_pageinteger
    Results per page, default 20, maximum 100. Example: 20.
    publicstring
    Only listed (true) or unlisted (false) campaigns. One of: true, false, 1, 0. Example: true.one of truefalse10
    scopestring
    Campaign scope filter, e.g. chapters to include chapter campaigns. Example: chapters.
  • givebutter_contact_activities_listList the activity timeline of a contact (notes, emails, calls, meetings, donations, tickets, subscriptions), optionally of one type.Read-only

    List Contact Activities

    List the activity timeline of a contact (notes, emails, calls, meetings, donations, tickets, subscriptions), optionally of one type. Returns per activity its ID, type, subject, note and date. Results are paged: data holds the records and meta the current page, last page and total.

    Inputs

    contactintegerrequired
    ID of the contact. Example: 9876543.
    pageinteger
    Page number, starting at 1. Example: 1.
    per_pageinteger
    Results per page, default 20, maximum 100. Example: 20.
    typestring
    Only activities of this type. One of: 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, created_task, ticket.issued, transaction.recieved, transaction.succeeded, transaction.acknowledged, transaction.unacknowledged, unarchived, volunteer_activity, soft_credited, tagged, untagged, custom_field.updated, video_message.sent, video_message.deleted. Example: note.one of archivedcampaign.joinedemailemail.subscribedemail.unsubscribedlettermeetingnotephone_callrecurring_plan.canceledrecurring_plan.createdrecurring_plan.activatedsignup_form.submittedsmssms.subscribedsms.unsubscribedsubscription_form.submittedcompleted_taskcreated_taskticket.issuedtransaction.recievedtransaction.succeededtransaction.acknowledgedtransaction.unacknowledgedunarchivedvolunteer_activitysoft_creditedtaggeduntaggedcustom_field.updatedvideo_message.sentvideo_message.deleted