# Hoppier Docs

> Add people to Hoppier reward programs with the REST API, receive card.claimed webhooks, use Zapier, and connect Claude or ChatGPT to Hoppier.

- [Hoppier developer documentation](https://docs.hoppier.com/index.md): Build on Hoppier: add people to reward programs with the REST API, get card.claimed webhooks, connect Zapier, or let Claude and ChatGPT run programs for you.
- [Authentication](https://docs.hoppier.com/guides/authentication.md): How Hoppier API keys work during the beta: how to get one, how to send it, and what it can do.
- [Quickstart](https://docs.hoppier.com/guides/quickstart.md): Check your Hoppier API key, find a program, add a participant and get their invite link in four requests.
- [Programs, participants, ids and units](https://docs.hoppier.com/guides/concepts.md): The objects the Hoppier API returns, what their ids look like, and the units used for money and dates.
- [Errors and rate limits](https://docs.hoppier.com/guides/errors-and-rate-limits.md): Hoppier API status codes, error bodies, safe retries with Idempotency-Key, and the two rate limits.
- [Webhooks](https://docs.hoppier.com/guides/webhooks.md): Receive a signed card.claimed event when Hoppier sets a reward aside for a participant, verify the signature, and handle retries.
- [Zapier](https://docs.hoppier.com/guides/zapier.md): Connect Hoppier to thousands of apps without code: the New Program trigger and the Add Participant action.
- [Coming soon](https://docs.hoppier.com/guides/coming-soon.md): What's next for the Hoppier API: self-serve API keys, program creation, participant lists, removals, occasion events and more.
- [Changelog](https://docs.hoppier.com/changelog.md): Changes to the Hoppier API, webhooks and AI-assistant connectors.
- [API reference](https://docs.hoppier.com/api-reference/overview.md): Base URL, authentication, ids, units and endpoints of the Hoppier REST API (closed beta).
- [Check your API key](https://docs.hoppier.com/api-reference/validate.md): Confirms that a key works and tells you which admin and company it belongs to.
- [List programs](https://docs.hoppier.com/api-reference/programs/list.md): Returns every program in the key's company, archived ones included (`status: inactive`). There is no paging and no guaranteed order.
- [Get a program](https://docs.hoppier.com/api-reference/programs/get.md): Returns one program in the key's company.
- [Add a participant](https://docs.hoppier.com/api-reference/participants/add.md): Adds one person to a program and returns their participant record, with a link they can use to claim their reward. The key's owner must be an admin of the company, and the account needs an active Hoppier subscription.
- [card.claimed](https://docs.hoppier.com/api-reference/webhooks/card-claimed.md): The card.claimed webhook: its payload, the X-Hoppier-Signature header and how Hoppier retries.
- [Hoppier for Claude and ChatGPT](https://docs.hoppier.com/ai-assistants/overview.md): Connect Claude, ChatGPT or another AI assistant to Hoppier over MCP: the Teams server for company admins and the Gift cards server for gift-card senders.
- [Connect Claude, ChatGPT or another client](https://docs.hoppier.com/ai-assistants/connect.md): Add Hoppier as a custom connector in Claude or ChatGPT, sign in and approve. Plus the OAuth and transport details client developers need.
- [Teams server tools](https://docs.hoppier.com/ai-assistants/teams-tools.md): The 13 tools on Hoppier's Teams MCP server for company admins: what each one does, what it needs, and its limits.
- [Gift cards server tools](https://docs.hoppier.com/ai-assistants/gift-card-tools.md): Search gift-card brands, send gift cards with a Stripe Checkout link, and check a send's status from Claude or ChatGPT.
- [Approvals and security](https://docs.hoppier.com/ai-assistants/approvals-and-security.md): How Hoppier's AI connectors keep a person in control: sign-in and consent, one company per connection, approvals, limits and revoking access.

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.