# Trophy Docs

## Docs

- [Billing](https://trophy-mintlify-0412bcbb.mintlify.app/account/billing.md): Understand Trophy's usage-based billing model, monthly active user pricing, free tier limits, and how the Starter and Pro plans compare.
- [Branding](https://trophy-mintlify-0412bcbb.mintlify.app/account/branding.md): Configure your account logo, fonts, brand color, app name, and app URL so Trophy emails and notifications match your product's visual identity.
- [Members](https://trophy-mintlify-0412bcbb.mintlify.app/account/members.md): Invite team members to your Trophy organization, manage admin and member roles, and control access to account settings from the dashboard.
- [Overview](https://trophy-mintlify-0412bcbb.mintlify.app/account/overview.md): Manage your Trophy organization, including team members, branding for emails and notifications, and usage-based billing for monthly active users.
- [Authentication](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/authentication.md): Authenticate Admin API requests with account-level API keys passed in the X-API-KEY header, using the same credentials as the Application API.
- [Client Libraries](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/client-libraries.md): Call the Trophy Admin API from Node.js, Python, Go, and other languages using the official type-safe SDKs under the trophy.admin namespace.
- [Create attributes](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/attributes/create-attributes.md): Create attributes.
- [Delete attributes](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/attributes/delete-attributes.md): Delete attributes by ID.
- [Get an attribute](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/attributes/get-an-attribute.md): Get an attribute by ID.
- [List attributes](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/attributes/list-attributes.md): List attributes.
- [Update attributes](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/attributes/update-attributes.md): Update attributes by ID.
- [Create leaderboards](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/leaderboards/create-leaderboards.md): Create leaderboards. Maximum 100 leaderboards per request.
- [Delete leaderboards](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/leaderboards/delete-leaderboards.md): Delete leaderboards by ID.
- [Get a leaderboard](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/leaderboards/get-a-leaderboard.md): Get a leaderboard by ID.
- [List leaderboards](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/leaderboards/list-leaderboards.md): List leaderboards.
- [Update leaderboards](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/leaderboards/update-leaderboards.md): Update leaderboards by ID. Updating `status` behaves the same as activating, scheduling, deactivating, or finishing a leaderboard in the dashboard.
- [Create metrics](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/metrics/create-metrics.md): Create metrics.
- [Delete metrics](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/metrics/delete-metrics.md): Delete metrics by ID.
- [Get a metric by ID](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/metrics/get-a-metric.md): Get a metric by ID.
- [List metrics](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/metrics/list-metrics.md): List metrics.
- [Update metrics](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/metrics/update-metrics.md): Update metrics by ID.
- [Create points boosts](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/create-boosts.md): Create points boosts.
- [Create points levels](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/create-levels.md): Create points levels. Maximum 100 levels per request.
- [Create points systems](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/create-points-systems.md): Create points systems. Optionally include sub-entities (levels, boosts, triggers) in each system payload to create them alongside the system.
- [Create points triggers](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/create-points-triggers.md): Create points triggers in bulk. Maximum 100 triggers per request.
- [Delete multiple points boosts](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/delete-boosts.md): Delete multiple points boosts by ID.
- [Delete multiple points levels](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/delete-levels.md): Delete multiple points levels by ID.
- [Delete points systems](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/delete-points-systems.md): Delete (archive) points systems by ID.
- [Delete points triggers](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/delete-points-triggers.md): Delete (archive) points triggers by ID. Maximum 100 trigger IDs per request.
- [Get a points boost by ID](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/get-a-boost.md): Get a single points boost by ID.
- [Get a points level by ID](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/get-a-level.md): Get a single points level by ID.
- [Get a points system by ID](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/get-a-points-system.md): Get a points system by ID.
- [Get a points trigger by ID](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/get-a-points-trigger.md): Get a single points trigger by ID.
- [List points boosts](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/list-boosts.md): List points boosts for a system.
- [List points levels](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/list-levels.md): List points levels for a system.
- [List points systems](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/list-points-systems.md): List points systems.
- [List points triggers](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/list-points-triggers.md): List points triggers for a system.
- [Update multiple points boosts](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/update-boosts.md): Update multiple points boosts.
- [Update multiple points levels](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/update-levels.md): Update multiple points levels. Each item must include an ID. `key` cannot be changed.
- [Update points systems](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/update-points-systems.md): Update points systems by ID.
- [Update points triggers](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/points/update-points-triggers.md): Update points triggers in bulk. Maximum 100 triggers per request. Only provided fields are updated; omitted fields are preserved.
- [Create streak freezes for multiple users](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/streaks/grant-freezes.md): Create streak freezes for multiple users.
- [Restore streaks for multiple users](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/streaks/restore-streaks.md): Restore streaks for multiple users to the maximum previously achieved streak length found within the current restore window: the last 90 days for daily streaks, weekly periods starting with the week containing the start of the current calendar year for weekly streaks, and monthly periods starting at…
- [Create tenants](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/tenants/create-tenants.md): Create tenants.
- [Delete tenants](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/tenants/delete-tenants.md): Delete tenants by ID.
- [Get a tenant](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/tenants/get-a-tenant.md): Get a tenant by ID.
- [List tenants](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/tenants/list-tenants.md): List tenants in the current environment.
- [Update tenants](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/endpoints/tenants/update-tenants.md): Update tenants by ID.
- [Introduction](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/introduction.md): Build custom gamification workflows with the Trophy Admin API, a set of endpoints for managing metrics, points, leaderboards, attributes, and tenants.
- [Rate Limiting](https://trophy-mintlify-0412bcbb.mintlify.app/admin-api/rate-limiting.md): Understand the request rate limits applied to every Trophy Admin API endpoint, the tier model used, and how to handle 429 Too Many Requests responses.
- [Authentication](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/authentication.md): Authenticate Trophy Application API requests with account-level API keys sent in the X-API-KEY header, and learn how to manage keys for each environment.
- [Client Libraries](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/client-libraries.md): Integrate the Trophy Application API from Node.js, Python, Go, Ruby, and other languages using the official type-safe SDKs and client libraries.
- [Get all achievements and their completion stats](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/achievements/all-achievements.md): Get all achievements and their completion stats.
- [Mark an achievement as completed](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/achievements/mark-an-achievement-as-completed.md): Mark an achievement as completed for a user.
- [Get all leaderboards](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/leaderboards/get-all-active-leaderboards.md): Get all leaderboards for your organization. Finished leaderboards are excluded by default.
- [Get a single leaderboard](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/leaderboards/get-leaderboard.md): Get a specific leaderboard by its key.
- [Send a metric change event](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/metrics/send-a-metric-change-event.md): Increment or decrement the value of a metric for a user.
- [Get a points system with its triggers](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/points/get-points.md): Get a points system with its triggers.
- [Get boosts for a points system](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/points/get-points-boosts.md): Get all global boosts for a points system. Finished boosts are excluded by default.
- [Get level summary for a points system](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/points/get-points-level-summary.md): Get a breakdown of the number of users at each level in a points system.
- [Get levels for a points system](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/points/get-points-levels.md): Get all levels for a points system.
- [Get a breakdown of users by points](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/points/get-points-summary.md): Get a breakdown of the number of users with points in each range.
- [Get top users by streak length](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/streaks/get-streak-rankings.md): Get the top users by streak length (active or longest).
- [Get the streak lengths of a list of users](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/streaks/get-streaks.md): Get the streak lengths of a list of users, ranked by streak length from longest to shortest.
- [Create a new user](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/create-a-user.md): Create a new user.
- [Get a summary of metric events over time](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-single-metric-event-summary-for-a-user.md): Get a summary of metric events over time for a user.
- [Get a single metric for a user](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-single-metric-for-a-user.md): Get a user's progress against a single active metric.
- [Get a single user](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-single-user.md): Get a single user.
- [Get a user's achievements](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-completed-achievements.md): Get a user's achievements.
- [Get a user's leaderboard data](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-leaderboard.md): Get a user's rank, value, and history for a specific leaderboard.
- [Get a user's points data](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-points.md): Get a user's points for a specific points system.
- [Get a user's active points boosts](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-points-boosts.md): Get active points boosts for a user in a specific points system. Returns both global boosts the user is eligible for and user-specific boosts.
- [Get a summary of points events over time](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-points-summary.md): Get a summary of points awards over time for a user for a specific points system.
- [Get a user's streak status](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-streak.md): Get a user's streak data.
- [Get a user's wrapped data](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-a-users-wrapped.md): Get a user's year-in-review wrapped data.
- [Get all metrics for a user](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-all-metrics-for-a-user.md): Get a single user's progress against all active metrics.
- [Get a user's preferences](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/get-user-preferences.md): Get a user's notification preferences.
- [Identify a user](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/identify-a-user.md): Identify a user.
- [Update a user](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/update-a-user.md): Update a user.
- [Update a user's preferences](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/endpoints/users/update-user-preferences.md): Update a user's notification preferences.
- [Idempotency](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/idempotency.md): Use the Idempotency-Key header to safely retry Trophy Application API requests, prevent duplicate side effects, and learn which endpoints support it.
- [Introduction](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/introduction.md): Start building gamification features with the Trophy Application API, the set of endpoints your app uses to track events and read user-facing data.
- [Rate Limiting](https://trophy-mintlify-0412bcbb.mintlify.app/api-reference/rate-limiting.md): Understand the tiered rate limits on each Trophy Application API endpoint, the organisation-level quotas, and how to handle 429 Too Many Requests errors.
- [Achievements](https://trophy-mintlify-0412bcbb.mintlify.app/features/achievements.md): Reward users with one-time and metric-based achievements in Trophy, including how to configure unlock criteria, completion logic, and backdating.
- [Emails](https://trophy-mintlify-0412bcbb.mintlify.app/features/emails.md): Send transactional and lifecycle emails for streaks, achievements, points, and leaderboards using Trophy's built-in templates and branding controls.
- [Events](https://trophy-mintlify-0412bcbb.mintlify.app/features/events.md): Send metric events to Trophy to represent user interactions, drive achievements, streaks, points, and leaderboards, and power gamified product flows.
- [Leaderboards](https://trophy-mintlify-0412bcbb.mintlify.app/features/leaderboards.md): Configure ranked, time-bound leaderboards in Trophy to drive competition between users, with support for custom scoring, tenants, and user attributes.
- [Metrics](https://trophy-mintlify-0412bcbb.mintlify.app/features/metrics.md): Learn how to model user interactions using Trophy Metrics. Model any user interaction and trigger automated gamification flows with just a few lines of code.
- [Overview](https://trophy-mintlify-0412bcbb.mintlify.app/features/overview.md): Understand the core Trophy concepts behind gamification, including metrics, events, achievements, streaks, points, and leaderboards, and how they connect.
- [Points](https://trophy-mintlify-0412bcbb.mintlify.app/features/points.md): Design points systems in Trophy with custom triggers, levels, and boosts to power XP-style progression, currencies, and reward loops in your product.
- [Push Notifications](https://trophy-mintlify-0412bcbb.mintlify.app/features/push-notifications.md): Send mobile push notifications for streaks, achievements, points, and leaderboards in Trophy, including device token management and delivery options.
- [Streaks](https://trophy-mintlify-0412bcbb.mintlify.app/features/streaks.md): Build daily, weekly, and custom streaks in Trophy to drive habit formation, with support for freezes, restores, and timezone-aware streak tracking.
- [Users](https://trophy-mintlify-0412bcbb.mintlify.app/features/users.md): Identify users in Trophy, attach custom attributes, and track interactions across your userbase to personalize gamification and segmentation in your app.
- [Welcome to Trophy](https://trophy-mintlify-0412bcbb.mintlify.app/getting-started/introduction.md): Explore Trophy's documentation for gamification APIs, including quickstart guides, feature overviews, SDK references, and end-to-end tutorials.
- [Quick Start](https://trophy-mintlify-0412bcbb.mintlify.app/getting-started/quickstart.md): Integrate Trophy into your backend in under 10 minutes by creating an account, adding the SDK, identifying users, and tracking your first metric event.
- [How to Build a Gamified Fitness Tracker](https://trophy-mintlify-0412bcbb.mintlify.app/guides/gamified-fitness-platform.md): Learn how to build a Strava-like fitness app with Next.js, featuring multi-sport tracking, city-based leaderboards, and normalized XP progression.
- [Environments](https://trophy-mintlify-0412bcbb.mintlify.app/platform/environments.md): Use Trophy environments to safely test and review gamification changes in staging before promoting them to production for your live users.
- [Experimentation](https://trophy-mintlify-0412bcbb.mintlify.app/platform/experimentation.md): Run experiments on Trophy's gamification features with control flags and audience targeting to measure their impact on retention and engagement.
- [Multi-Tenancy](https://trophy-mintlify-0412bcbb.mintlify.app/platform/multi-tenancy.md): Use Trophy's multi-tenancy to configure and customize gamification features per customer, with isolated data, settings, and leaderboards per tenant.
- [Overview](https://trophy-mintlify-0412bcbb.mintlify.app/platform/overview.md): Configure and operate the Trophy platform with environments, multi-tenancy, experimentation, and other tools for managing gamification at scale.
- [Gamification UI Kit](https://trophy-mintlify-0412bcbb.mintlify.app/uikit/overview.md): Ship gamification UI faster with Trophy's shadcn/ui-based component library for streaks, achievements, points, leaderboards, and more in React apps.
- [Achievement completed](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/achievements/achievement-completed.md): Triggered when a user completes an achievement.
- [Leaderboard changed](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/leaderboards/leaderboard-changed.md): Triggered when leaderboard rankings change.
- [Leaderboard finished](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/leaderboards/leaderboard-finished.md): Triggered when a run of a leaderboard finishes.
- [Leaderboard rank changed](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/leaderboards/leaderboard-rank-changed.md): Triggered when a user's leaderboard rank changes.
- [Leaderboard started](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/leaderboards/leaderboard-started.md): Triggered when a run of a leaderboard begins.
- [Points boost finished](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/points/points-boost-finished.md): Triggered when a points boost ends (its end time has been reached).
- [Points boost started](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/points/points-boost-started.md): Triggered when a points boost goes live (its start time has been reached).
- [Points changed](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/points/points-changed.md): Triggered when a user is awarded or loses points. This event is fired a maximum of once per user per points system per minute.
- [Points level changed](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/points/points-level-changed.md): Triggered when a user's level changes within a points system as a result of earning or losing points.
- [Streak extended](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/streaks/streak-extended.md): Triggered when a user extends an existing active streak.
- [Streak freeze consumed](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/streaks/streak-freeze-consumed.md): Triggered when a user consumes a streak freeze.
- [Streak freeze earned](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/streaks/streak-freeze-earned.md): Triggered when a user earns streak freezes.
- [Streak lost](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/streaks/streak-lost.md): Triggered when a user loses their streak.
- [Streak started](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/events/streaks/streak-started.md): Triggered when a user starts a streak.
- [Idempotency](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/idempotency.md): Make your Trophy webhook handlers idempotent using event IDs to safely process duplicate deliveries and avoid unintended side effects on retries.
- [Introduction](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/introduction.md): Use Trophy webhooks to react to gamification events like streak changes, achievement completions, and points updates from your own backend services.
- [Observability](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/observability.md): Monitor Trophy webhook delivery, inspect attempts and response codes, and diagnose failed deliveries from the dashboard to keep integrations healthy.
- [Quick Start](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/quickstart.md): Start receiving Trophy webhook events in under 10 minutes by registering an endpoint, verifying signatures, and handling your first achievement event.
- [Retries](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/retries.md): Understand how Trophy retries failed webhook deliveries with exponential backoff, when retries stop, and how to recover after extended endpoint outages.
- [Security](https://trophy-mintlify-0412bcbb.mintlify.app/webhooks/security.md): Secure your Trophy webhook endpoints by verifying request signatures with your signing secret to ensure each event came from Trophy and is untampered.

## OpenAPI Specs

- [application](https://trophy-mintlify-0412bcbb.mintlify.app/openapi/application.yml)
- [admin](https://trophy-mintlify-0412bcbb.mintlify.app/openapi/admin.yml)

## Optional

- [GitHub](https://github.com/trophyso)
- [Status](https://status.trophy.so)
- [llms.txt](https://docs.trophy.so/llms-full.txt)
- [Help](mailto:support@trophy.so)
- [GitHub](https://github.com/trophyso)
- [Estado](https://status.trophy.so)
- [llms.txt](https://docs.trophy.so/llms-full.txt)
- [Ayuda](mailto:support@trophy.so)