Givebutter

BUSINESS · COMMERCE & FINANCE

Campaigns, contacts, transactions and payouts under that person’s own token.

Connect Givebutter with Fabriq Developer

Your user pastes their Givebutter credential on a page Agentic Fabriq hosts, so it never reaches your backend and never becomes one shared key across all of your users. Same call as OAuth, one more argument.

from af_sdk import AgenticFabriq

af = AgenticFabriq()                      # reads AF_APP_ID / AF_APP_SECRET

url = await af.initiate_connection(request, provider="givebutter", method="api_key")
return redirect(url)                      # an AF-hosted page, not yours

async with await af.for_user(request) as session:
    tools = await session.get_tools()     # only what this user granted

Provider names are surfaces, not vendors, and the authoritative list is the capabilities endpoint rather than any page including this one — an unknown name returns 400 with the valid list. Fabriq Developer is free to start and needs no provider paperwork. Start free or read the quickstart.

Connecting Givebutter in practice

Givebutter allows 500 requests a minute but pages with 1-indexed offset pagination at 20 items by default and 100 at most, so pulling a year of transactions is hundreds of sequential calls against a limit that cannot be parallelised away. A key that authenticates fine still returns 403 for anything outside the organization it was issued in.

Rate limits

500 requests per minute, after which the API returns 429.
429 responses carry a Retry-After header stating how many seconds to wait.
Paginated endpoints: per_page defaults to 20 with a maximum of 100; asking for more is an error.

Worth knowing

Pagination is offset-based with 1-indexed page numbers and a links object; Givebutter’s advice is to "keep following next until it becomes null", so total page count is not known up front.
A valid key can still receive 403 because it lacks permission for the resource or is "trying to access another organization’s data" — so 403 here is a scoping signal, not a bad credential.
Keys are created in Settings → Integrations → API Keys and shown once: "your API key is shown only once", so an agent’s credential can be replaced but never re-read.

Checked against Authentication (2026-09-29), Rate limits (2026-09-29), Pagination (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

givebutter_delete_v1_campaigns_by_campaignWRITE

Delete a campaign via DELETE /v1/campaigns/{campaign}

api

givebutter_delete_v1_campaigns_by_campaign_discount_codes_by_discountcodeWRITE

Delete a discount code via DELETE /v1/campaigns/{campaign}/discount-codes/{discountCode}

api

givebutter_delete_v1_campaigns_by_campaign_members_by_memberWRITE

Delete a campaign member via DELETE /v1/campaigns/{campaign}/members/{member}

api

givebutter_delete_v1_campaigns_by_campaign_teams_by_teamWRITE

Delete a campaign team via DELETE /v1/campaigns/{campaign}/teams/{team}

api

givebutter_delete_v1_contacts_by_contactWRITE

Delete a contact via DELETE /v1/contacts/{contact}

api

givebutter_delete_v1_contacts_by_contact_activities_by_activityWRITE

Delete a contact activity via DELETE /v1/contacts/{contact}/activities/{activity}

api

givebutter_delete_v1_funds_by_fundWRITE

Delete a fund via DELETE /v1/funds/{fund}

api

givebutter_delete_v1_households_by_householdWRITE

Delete a household via DELETE /v1/households/{household}

api

givebutter_delete_v1_households_by_household_contacts_by_contactWRITE

Remove a contact from a household via DELETE /v1/households/{household}/contacts/{contact}

api

givebutter_delete_v1_webhooks_by_webhookWRITE

Delete a webhook via DELETE /v1/webhooks/{webhook}

api

givebutter_get_sso_v1_accountREAD

GET /sso/v1/account

api

givebutter_get_sso_v1_campaigns_by_campaignREAD

GET /sso/v1/campaigns/{campaign}

api

givebutter_get_v1_campaignsREAD

List all campaigns via GET /v1/campaigns

api

givebutter_get_v1_campaigns_by_campaignREAD

Get a campaign via GET /v1/campaigns/{campaign}

api

givebutter_get_v1_campaigns_by_campaign_discount_codesREAD

List all discount codes via GET /v1/campaigns/{campaign}/discount-codes

api

givebutter_get_v1_campaigns_by_campaign_discount_codes_by_discountcodeREAD

Get a discount code via GET /v1/campaigns/{campaign}/discount-codes/{discountCode}

api

givebutter_get_v1_campaigns_by_campaign_items_ticketsREAD

List all campaign tickets via GET /v1/campaigns/{campaign}/items/tickets

api

givebutter_get_v1_campaigns_by_campaign_items_tickets_by_ticketidREAD

Get a campaign ticket via GET /v1/campaigns/{campaign}/items/tickets/{ticketId}

api

givebutter_get_v1_campaigns_by_campaign_membersREAD

List all campaign members via GET /v1/campaigns/{campaign}/members

api

givebutter_get_v1_campaigns_by_campaign_members_by_memberREAD

Get a campaign member via GET /v1/campaigns/{campaign}/members/{member}

api

givebutter_get_v1_campaigns_by_campaign_teamsREAD

List all campaign teams via GET /v1/campaigns/{campaign}/teams

api

givebutter_get_v1_campaigns_by_campaign_teams_by_teamREAD

Get a campaign team via GET /v1/campaigns/{campaign}/teams/{team}

api

givebutter_get_v1_contactsREAD

List all contacts via GET /v1/contacts

api

givebutter_get_v1_contacts_by_contactREAD

Get a contact via GET /v1/contacts/{contact}

api

givebutter_get_v1_contacts_by_contact_activitiesREAD

List all contact activities via GET /v1/contacts/{contact}/activities

api

givebutter_get_v1_contacts_by_contact_activities_by_activityREAD

Get a contact activity via GET /v1/contacts/{contact}/activities/{activity}

api

givebutter_get_v1_fundsREAD

List all funds via GET /v1/funds

api

givebutter_get_v1_funds_by_fundREAD

Get a fund via GET /v1/funds/{fund}

api

givebutter_get_v1_householdsREAD

List all households via GET /v1/households

api

givebutter_get_v1_households_by_householdREAD

Get a household via GET /v1/households/{household}

api

givebutter_get_v1_households_by_household_contactsREAD

List all contacts associated with a household via GET /v1/households/{household}/contacts

api

givebutter_get_v1_households_by_household_contacts_by_contactREAD

Get a contact associated with a household via GET /v1/households/{household}/contacts/{contact}

api

givebutter_get_v1_messagesREAD

List all messages via GET /v1/messages

api

givebutter_get_v1_messages_by_messageREAD

Get a message via GET /v1/messages/{message}

api

givebutter_get_v1_payoutsREAD

List all payouts via GET /v1/payouts

api

givebutter_get_v1_payouts_by_payoutREAD

Get a payout via GET /v1/payouts/{payout}

api

givebutter_get_v1_plansREAD

List all recurring plans via GET /v1/plans

api

givebutter_get_v1_plans_by_planREAD

Get a recurring plan via GET /v1/plans/{plan}

api

givebutter_get_v1_pledgesREAD

List all pledges via GET /v1/pledges

api

givebutter_get_v1_pledges_by_pledgeREAD

Get a pledge via GET /v1/pledges/{pledge}

api

givebutter_get_v1_ticketsREAD

List all tickets via GET /v1/tickets

api

givebutter_get_v1_tickets_by_ticketREAD

Get a ticket via GET /v1/tickets/{ticket}

api

givebutter_get_v1_transactionsREAD

List all transactions via GET /v1/transactions

api

givebutter_get_v1_transactions_by_transactionREAD

Get a transaction via GET /v1/transactions/{transaction}

api

givebutter_get_v1_webhooksREAD

List all webhooks via GET /v1/webhooks

api

givebutter_get_v1_webhooks_by_webhookREAD

Get a webhook via GET /v1/webhooks/{webhook}

api

givebutter_get_v1_webhooks_by_webhook_activitiesREAD

List all webhook activities via GET /v1/webhooks/{webhook}/activities

api

givebutter_get_v1_webhooks_by_webhook_activities_by_activityREAD

Get a webhook activity via GET /v1/webhooks/{webhook}/activities/{activity}

api

givebutter_patch_v1_contacts_by_contact_restoreWRITE

Restore a contact via PATCH /v1/contacts/{contact}/restore

api

givebutter_post_v1_campaignsWRITE

Create a campaign via POST /v1/campaigns

api

givebutter_post_v1_campaigns_by_campaign_discount_codesWRITE

Create a discount code via POST /v1/campaigns/{campaign}/discount-codes

api

givebutter_post_v1_campaigns_by_campaign_items_ticketsWRITE

Create a campaign ticket via POST /v1/campaigns/{campaign}/items/tickets

api

givebutter_post_v1_contactsWRITE

Create a contact via POST /v1/contacts

api

givebutter_post_v1_contacts_by_contact_activitiesWRITE

Create a contact activity via POST /v1/contacts/{contact}/activities

api

givebutter_post_v1_contacts_by_contact_tags_addWRITE

Add tags to a contact via POST /v1/contacts/{contact}/tags/add

api

givebutter_post_v1_contacts_by_contact_tags_removeWRITE

Remove tags from a contact via POST /v1/contacts/{contact}/tags/remove

api

givebutter_post_v1_contacts_by_contact_tags_syncWRITE

Sync tags for a contact via POST /v1/contacts/{contact}/tags/sync

api

givebutter_post_v1_fundsWRITE

Create a fund via POST /v1/funds

api

givebutter_post_v1_householdsWRITE

Create a household via POST /v1/households

api

givebutter_post_v1_households_by_household_contactsWRITE

Add a contact to a household via POST /v1/households/{household}/contacts

api

givebutter_post_v1_transactionsWRITE

Create a transaction via POST /v1/transactions

api

givebutter_post_v1_webhooksWRITE

Create a webhook via POST /v1/webhooks

api

givebutter_put_v1_campaigns_by_campaignWRITE

Update a campaign via PUT /v1/campaigns/{campaign}

api

givebutter_put_v1_campaigns_by_campaign_discount_codes_by_discountcodeWRITE

Update a discount code via PUT /v1/campaigns/{campaign}/discount-codes/{discountCode}

api

givebutter_put_v1_contacts_by_contactWRITE

Update a contact via PUT /v1/contacts/{contact}

api

givebutter_put_v1_contacts_by_contact_activities_by_activityWRITE

Update a contact activity via PUT /v1/contacts/{contact}/activities/{activity}

api

givebutter_put_v1_funds_by_fundWRITE

Update a fund via PUT /v1/funds/{fund}

api

givebutter_put_v1_households_by_householdWRITE

Update a household via PUT /v1/households/{household}

api

givebutter_put_v1_transactions_by_transactionWRITE

Update a transaction via PUT /v1/transactions/{transaction}

api

givebutter_put_v1_webhooks_by_webhookWRITE

Update a webhook via PUT /v1/webhooks/{webhook}

api

Often connected alongside

Put Givebutter behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.

Start free See pricing