API and Integrations

The HelpOut API

HelpOut has a read-only REST API available to every account. Use it to pull your events and responses into a spreadsheet, a dashboard, a website, or anything else you build.

Full endpoint reference: helpout.us/developer.

Getting Your API Key

Sign in at helpout.us.
Click Account at the bottom of the left sidebar, then API — or open helpout.us/users/api directly.
Click Copy to copy your key.

If you’re on more than one team in HelpOut, `/events` returns events from all of them, not just the ones you personally created. If you’re the only person on your team, nothing about this changes what you get back.

Events

curl --header "X-API-Key: YOUR_API_KEY" \
  https://helpout.us/api/v1/events

Each event includes its id, url, title, eventat, description (as plain text and as HTML), eventtype, location, owner, imageurl if a header image is attached, and timestamps. Gift It! events also include recipientname, recipient_email, and the contributions total.

Responses

curl --header "X-API-Key: YOUR_API_KEY" \
  https://helpout.us/api/v1/events/walnut-grove-science-fair/responses

Responses and contributions come back in one list, and the fields tell them apart:

Show Up! responses have quantity and rsvp
Bring It! and Sign Up! responses have quantity and a slots array; on Sign Up! events each slot carries start_date and end_date
Gift It! contributions have amount and processing_fee

All timestamps are UTC in ISO 8601 format.

Rate Limits

Endpoint	Limit
`/events` and `/events/:id/responses`	100 requests per minute
`/ping`	10 requests per minute

Going over returns 429 Too Many Requests. If you’re syncing on a schedule, poll every few minutes rather than continuously — event data doesn’t change that fast.

Scope

The API is read-only. Events, responses, and contributions can’t be created or changed through it, and it only ever returns data your key’s owner can already see in HelpOut — their own team’s events, or every team’s events if they belong to more than one.