Givebutter Household Contacts API
The Household Contacts API from Givebutter — 4 operation(s) for household contacts. Split by tag from Givebutter's own published OpenAPI at https://givebutter.com/docs/api.json (harvested 2026-09-12).
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/givebutter-household-contacts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Givebutter API Documentation Household Contacts API
version: 1.0.0
description: Givebutter Public API - Access and manage your campaigns, contacts, transactions, and more.
servers:
- url: https://api.givebutter.com/
security:
- http: []
tags:
- name: Household Contacts
paths:
/v1/households/{household}/contacts:
get:
operationId: households.contacts.index
summary: List all contacts associated with a household
tags:
- Household Contacts
parameters:
- name: household
in: path
required: true
description: The household ID
schema:
type: integer
responses:
'200':
description: Paginated set of `ContactResource`
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ContactResource'
links:
type: object
properties:
first:
type:
- string
- 'null'
last:
type:
- string
- 'null'
prev:
type:
- string
- 'null'
next:
type:
- string
- 'null'
required:
- first
- last
- prev
- next
meta:
type: object
properties:
current_page:
type: integer
minimum: 1
from:
type:
- integer
- 'null'
minimum: 1
last_page:
type: integer
minimum: 1
links:
type: array
description: Generated paginator links.
items:
type: object
properties:
url:
type:
- string
- 'null'
label:
type: string
active:
type: boolean
required:
- url
- label
- active
path:
type:
- string
- 'null'
description: Base path for paginator generated URLs.
per_page:
type: integer
description: Number of items shown per page.
minimum: 0
to:
type:
- integer
- 'null'
description: Number of the last item in the slice.
minimum: 1
total:
type: integer
description: Total number of items being paginated.
minimum: 0
required:
- current_page
- from
- last_page
- links
- path
- per_page
- to
- total
required:
- data
- links
- meta
'403':
$ref: '#/components/responses/AuthorizationException'
'404':
$ref: '#/components/responses/ModelNotFoundException'
post:
operationId: households.contacts.store
summary: Add a contact to a household
tags:
- Household Contacts
parameters:
- name: household
in: path
required: true
description: The household ID
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
contact_id:
type: integer
required:
- contact_id
responses:
'200':
description: '`App.Http.Resources.API.HouseholdResource`'
content:
application/json:
schema:
$ref: '#/components/schemas/App.Http.Resources.API.HouseholdResource'
'422':
$ref: '#/components/responses/ValidationException'
'403':
$ref: '#/components/responses/AuthorizationException'
'404':
$ref: '#/components/responses/ModelNotFoundException'
/v1/households/{household}/contacts/{contact}:
get:
operationId: households.contacts.show
summary: Get a contact associated with a household
tags:
- Household Contacts
parameters:
- name: household
in: path
required: true
description: The household ID
schema:
type: integer
- name: contact
in: path
required: true
description: The contact ID
schema:
type: integer
responses:
'200':
description: '`ContactResource`'
content:
application/json:
schema:
$ref: '#/components/schemas/ContactResource'
'403':
$ref: '#/components/responses/AuthorizationException'
'404':
$ref: '#/components/responses/ModelNotFoundException'
delete:
operationId: households.contacts.destroy
summary: Remove a contact from a household
tags:
- Household Contacts
parameters:
- name: household
in: path
required: true
description: The household ID
schema:
type: integer
- name: contact
in: path
required: true
description: The contact ID
schema:
type: integer
responses:
'200':
description: '`App.Http.Resources.API.HouseholdResource`'
content:
application/json:
schema:
$ref: '#/components/schemas/App.Http.Resources.API.HouseholdResource'
'403':
$ref: '#/components/responses/AuthorizationException'
'404':
$ref: '#/components/responses/ModelNotFoundException'
components:
schemas:
AssociatedCompanyResource:
type: object
properties:
id:
type: string
type:
type: string
company_name:
type: string
name_display:
type: string
title:
type: string
twitter_url:
type: string
linkedin_url:
type: string
facebook_url:
type: string
tiktok_url:
type: string
instagram_url:
type: string
website_url:
type: string
image_url:
type:
- string
- 'null'
emails:
type: object
additionalProperties: {}
phones:
type: object
additionalProperties: {}
primary_email:
type: string
primary_phone:
type: string
is_email_subscribed:
type: string
is_phone_subscribed:
type: string
is_address_subscribed:
type: string
address_unsubscribed_at:
type: string
note:
type: string
addresses:
type: array
items:
$ref: '#/components/schemas/AddressResource'
primary_address:
$ref: '#/components/schemas/AddressResource'
archived_at:
type: string
created_at:
type: string
updated_at:
type: string
first_time_supporter_at:
type: string
required:
- id
- type
- company_name
- name_display
- title
- twitter_url
- linkedin_url
- facebook_url
- tiktok_url
- instagram_url
- website_url
- image_url
- emails
- phones
- primary_email
- primary_phone
- is_email_subscribed
- is_phone_subscribed
- is_address_subscribed
- address_unsubscribed_at
- note
- addresses
- primary_address
- archived_at
- created_at
- updated_at
- first_time_supporter_at
title: AssociatedCompanyResource
App.Http.Resources.API.HouseholdResource:
type: object
properties:
id:
type: integer
name:
type: string
head_contact_id:
type:
- integer
- 'null'
account_id:
type: integer
envelope_name:
type:
- string
- 'null'
note:
type:
- string
- 'null'
created_at:
type: string
updated_at:
type: string
contacts:
type: array
items:
$ref: '#/components/schemas/ContactResource'
required:
- id
- name
- head_contact_id
- account_id
- envelope_name
- note
- created_at
- updated_at
title: App.Http.Resources.API.HouseholdResource
EmailResource:
type: object
properties:
type:
type:
- string
- 'null'
value:
type:
- string
- 'null'
required:
- type
- value
title: EmailResource
ContactResource:
type: object
properties:
id:
type: string
external_id:
type: string
contact_since:
type: string
type:
type: string
prefix:
type: string
first_name:
type: string
preferred_name:
type: string
middle_name:
type: string
last_name:
type: string
suffix:
type: string
gender:
type: string
pronouns:
type: string
dob:
type: string
company:
type: string
employer:
type: string
company_name:
type: string
point_of_contact:
anyOf:
- $ref: '#/components/schemas/PointOfContactResource'
- type: 'null'
associated_companies:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/AssociatedCompanyResource'
title:
type: string
website_url:
type: string
twitter_url:
type: string
linkedin_url:
type: string
facebook_url:
type: string
tiktok_url:
type: string
instagram_url:
type: string
emails:
type: array
items:
$ref: '#/components/schemas/EmailResource'
phones:
type: array
items:
$ref: '#/components/schemas/PhoneResource'
primary_email:
type: string
primary_phone:
type: string
note:
type: string
addresses:
type: array
items:
$ref: '#/components/schemas/App.Http.Resources.API.AddressResource'
primary_address:
anyOf:
- $ref: '#/components/schemas/App.Http.Resources.API.AddressResource'
- type: 'null'
last_donation_amount:
type: string
stats:
type: object
properties:
total_contributions:
type: string
recurring_contributions:
type: string
required:
- total_contributions
- recurring_contributions
tags:
type: string
custom_fields:
type: array
items: {}
external_ids:
type: array
items:
$ref: '#/components/schemas/ExternalIdResource'
is_email_subscribed:
type: string
is_phone_subscribed:
type: string
is_address_subscribed:
type: string
email_opt_in:
type: string
sms_opt_in:
type: string
address_unsubscribed_at:
type: string
archived_at:
type: string
created_at:
type: string
updated_at:
type: string
salutation_name:
type: string
required:
- id
- external_id
- contact_since
- type
- prefix
- first_name
- preferred_name
- middle_name
- last_name
- suffix
- gender
- pronouns
- dob
- company
- employer
- company_name
- title
- website_url
- twitter_url
- linkedin_url
- facebook_url
- tiktok_url
- instagram_url
- emails
- phones
- primary_email
- primary_phone
- note
- addresses
- primary_address
- last_donation_amount
- stats
- tags
- custom_fields
- external_ids
- is_email_subscribed
- is_phone_subscribed
- is_address_subscribed
- email_opt_in
- sms_opt_in
- address_unsubscribed_at
- archived_at
- created_at
- updated_at
- salutation_name
title: ContactResource
ExternalIdResource:
type: object
properties:
id:
type: integer
label:
type: string
external_id:
type: string
created_at:
type: string
updated_at:
type: string
required:
- id
- label
- external_id
- created_at
- updated_at
title: ExternalIdResource
AddressResource:
type: object
properties:
id:
type: integer
account_id:
type:
- integer
- 'null'
name:
type:
- string
- 'null'
address_1:
type: string
address_2:
type:
- string
- 'null'
city:
type: string
state:
type:
- string
- 'null'
zipcode:
type:
- string
- 'null'
country:
type: string
type:
type: string
is_primary:
type: boolean
created_at:
type:
- string
- 'null'
format: date-time
updated_at:
type:
- string
- 'null'
format: date-time
required:
- id
- account_id
- name
- address_1
- address_2
- city
- state
- zipcode
- country
- type
- is_primary
- created_at
- updated_at
title: AddressResource
App.Http.Resources.API.AddressResource:
type: object
properties:
address_1:
type: string
address_2:
type:
- string
- 'null'
city:
type: string
state:
type:
- string
- 'null'
zipcode:
type:
- string
- 'null'
country:
type: string
type:
type: string
is_primary:
type: boolean
created_at:
type:
- string
- 'null'
format: date-time
updated_at:
type:
- string
- 'null'
format: date-time
required:
- address_1
- address_2
- city
- state
- zipcode
- country
- type
- is_primary
- created_at
- updated_at
title: App.Http.Resources.API.AddressResource
PhoneResource:
type: object
properties:
type:
type:
- string
- 'null'
value:
type:
- string
- 'null'
required:
- type
- value
title: PhoneResource
PointOfContactResource:
type: object
properties:
id:
type: string
type:
type: string
prefix:
type: string
first_name:
type: string
middle_name:
type: string
last_name:
type: string
suffix:
type: string
gender:
type: string
pronouns:
type: string
dob:
type: string
employer:
type: string
title:
type: string
twitter_url:
type: string
linkedin_url:
type: string
facebook_url:
type: string
tiktok_url:
type: string
instagram_url:
type: string
website_url:
type: string
emails:
type: object
additionalProperties: {}
phones:
type: object
additionalProperties: {}
primary_email:
type: string
primary_phone:
type: string
is_email_subscribed:
type: string
is_phone_subscribed:
type: string
is_address_subscribed:
type: string
address_unsubscribed_at:
type: string
archived_at:
type: string
created_at:
type: string
updated_at:
type: string
first_time_supporter_at:
type: string
required:
- id
- type
- prefix
- first_name
- middle_name
- last_name
- suffix
- gender
- pronouns
- dob
- employer
- title
- twitter_url
- linkedin_url
- facebook_url
- tiktok_url
- instagram_url
- website_url
- emails
- phones
- primary_email
- primary_phone
- is_email_subscribed
- is_phone_subscribed
- is_address_subscribed
- address_unsubscribed_at
- archived_at
- created_at
- updated_at
- first_time_supporter_at
title: PointOfContactResource
responses:
ValidationException:
description: Validation error
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Errors overview.
errors:
type: object
description: A detailed description of each field that failed validation.
additionalProperties:
type: array
items:
type: string
required:
- message
- errors
AuthorizationException:
description: Authorization error
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error overview.
required:
- message
ModelNotFoundException:
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error overview.
required:
- message
securitySchemes:
http:
type: http
scheme: bearer