# Trophy Docs

## Docs

- [Billing](https://trophy-mintlify-04769b11.mintlify.app/account/billing.md): Learn how Trophy controls gamification platform costs by charging based on the number of monthly active users (MAU) tracked in your account.
- [Branding](https://trophy-mintlify-04769b11.mintlify.app/account/branding.md): Configure your account's logo, brand colors, and visual identity used across emails, dashboards, and other Trophy gamification features.
- [Members](https://trophy-mintlify-04769b11.mintlify.app/account/members.md): Invite team members, manage roles, and control who has access to your Trophy account, environments, and gamification configuration.
- [Overview](https://trophy-mintlify-04769b11.mintlify.app/account/overview.md): Manage your Trophy account, including billing, branding, team members, and the settings that apply across every environment in your workspace.
- [Authentication](https://trophy-mintlify-04769b11.mintlify.app/admin-api/authentication.md): Authenticate Admin API requests using account-level API keys passed in the `X-API-KEY` header to manage metrics, points, leaderboards, and tenants.
- [Client Libraries](https://trophy-mintlify-04769b11.mintlify.app/admin-api/client-libraries.md): Call the Trophy Admin API from your backend using the official type-safe SDKs for Node.js, Python, Go, Java, Ruby, and other supported languages.
- [Create attributes](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/attributes/create-attributes.md): Create attributes.
- [Delete attributes](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/attributes/delete-attributes.md): Delete attributes by ID.
- [Get an attribute](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/attributes/get-an-attribute.md): Get an attribute by ID.
- [List attributes](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/attributes/list-attributes.md): List attributes.
- [Update attributes](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/attributes/update-attributes.md): Update attributes by ID.
- [Create leaderboards](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/leaderboards/create-leaderboards.md): Create leaderboards. Maximum 100 leaderboards per request.
- [Delete leaderboards](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/leaderboards/delete-leaderboards.md): Delete leaderboards by ID.
- [Get a leaderboard](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/leaderboards/get-a-leaderboard.md): Get a leaderboard by ID.
- [List leaderboards](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/leaderboards/list-leaderboards.md): List leaderboards.
- [Update leaderboards](https://trophy-mintlify-04769b11.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-04769b11.mintlify.app/admin-api/endpoints/metrics/create-metrics.md): Create metrics.
- [Delete metrics](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/metrics/delete-metrics.md): Delete metrics by ID.
- [Get a metric by ID](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/metrics/get-a-metric.md): Get a metric by ID.
- [List metrics](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/metrics/list-metrics.md): List metrics.
- [Update metrics](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/metrics/update-metrics.md): Update metrics by ID.
- [Create points boosts](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/create-boosts.md): Create points boosts.
- [Create points levels](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/create-levels.md): Create points levels. Maximum 100 levels per request.
- [Create points systems](https://trophy-mintlify-04769b11.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-04769b11.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-04769b11.mintlify.app/admin-api/endpoints/points/delete-boosts.md): Delete multiple points boosts by ID.
- [Delete multiple points levels](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/delete-levels.md): Delete multiple points levels by ID.
- [Delete points systems](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/delete-points-systems.md): Delete (archive) points systems by ID.
- [Delete points triggers](https://trophy-mintlify-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.mintlify.app/admin-api/endpoints/points/get-a-points-trigger.md): Get a single points trigger by ID.
- [List points boosts](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/list-boosts.md): List points boosts for a system.
- [List points levels](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/list-levels.md): List points levels for a system.
- [List points systems](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/list-points-systems.md): List points systems.
- [List points triggers](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/list-points-triggers.md): List points triggers for a system.
- [Update multiple points boosts](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/points/update-boosts.md): Update multiple points boosts.
- [Update multiple points levels](https://trophy-mintlify-04769b11.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-04769b11.mintlify.app/admin-api/endpoints/points/update-points-systems.md): Update points systems by ID.
- [Update points triggers](https://trophy-mintlify-04769b11.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-04769b11.mintlify.app/admin-api/endpoints/streaks/grant-freezes.md): Create streak freezes for multiple users.
- [Restore streaks for multiple users](https://trophy-mintlify-04769b11.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-04769b11.mintlify.app/admin-api/endpoints/tenants/create-tenants.md): Create tenants.
- [Delete tenants](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/tenants/delete-tenants.md): Delete tenants by ID.
- [Get a tenant](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/tenants/get-a-tenant.md): Get a tenant by ID.
- [List tenants](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/tenants/list-tenants.md): List tenants in the current environment.
- [Update tenants](https://trophy-mintlify-04769b11.mintlify.app/admin-api/endpoints/tenants/update-tenants.md): Update tenants by ID.
- [Introduction](https://trophy-mintlify-04769b11.mintlify.app/admin-api/introduction.md): Use the Trophy Admin API to programmatically create and manage metrics, points systems, leaderboards, achievements, tenants, and other resources.
- [Rate Limiting](https://trophy-mintlify-04769b11.mintlify.app/admin-api/rate-limiting.md): Understand Admin API rate limits, the response headers Trophy returns, and how to handle 429 responses gracefully when running automated workflows.
- [Authentication](https://trophy-mintlify-04769b11.mintlify.app/api-reference/authentication.md): Authenticate Trophy Application API requests using account-level API keys sent in the `X-API-KEY` header from your backend or trusted server environments.
- [Client Libraries](https://trophy-mintlify-04769b11.mintlify.app/api-reference/client-libraries.md): Integrate with the Trophy Application API using official type-safe SDKs for Node.js, Python, Go, Java, Ruby, and other backend languages.
- [Get all achievements and their completion stats](https://trophy-mintlify-04769b11.mintlify.app/api-reference/endpoints/achievements/all-achievements.md): Get all achievements and their completion stats.
- [Mark an achievement as completed](https://trophy-mintlify-04769b11.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-04769b11.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-04769b11.mintlify.app/api-reference/endpoints/leaderboards/get-leaderboard.md): Get a specific leaderboard by its key.
- [Send a metric change event](https://trophy-mintlify-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.mintlify.app/api-reference/endpoints/users/get-a-single-user.md): Get a single user.
- [Get a user's achievements](https://trophy-mintlify-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.mintlify.app/api-reference/endpoints/users/get-user-preferences.md): Get a user's notification preferences.
- [Identify a user](https://trophy-mintlify-04769b11.mintlify.app/api-reference/endpoints/users/identify-a-user.md): Identify a user.
- [Update a user](https://trophy-mintlify-04769b11.mintlify.app/api-reference/endpoints/users/update-a-user.md): Update a user.
- [Update a user's preferences](https://trophy-mintlify-04769b11.mintlify.app/api-reference/endpoints/users/update-user-preferences.md): Update a user's notification preferences.
- [Idempotency](https://trophy-mintlify-04769b11.mintlify.app/api-reference/idempotency.md): Use the `Idempotency-Key` header to safely retry Trophy API requests without double-counting events, double-awarding points, or duplicating user actions.
- [Introduction](https://trophy-mintlify-04769b11.mintlify.app/api-reference/introduction.md): Get started with the Trophy Application API to track events, award points, run leaderboards, and power gamified product experiences for your users.
- [Rate Limiting](https://trophy-mintlify-04769b11.mintlify.app/api-reference/rate-limiting.md): Understand Application API rate limits per endpoint, the headers Trophy returns, and how to handle 429 responses when tracking high-volume user events.
- [Achievements](https://trophy-mintlify-04769b11.mintlify.app/features/achievements.md): Use Trophy Achievements to reward users for completing milestones, unlocking badges, and reaching goals inside your gamified web or mobile product.
- [Emails](https://trophy-mintlify-04769b11.mintlify.app/features/emails.md): Send branded gamification emails for milestones, streak reminders, achievements, and level-ups directly from Trophy without running your own mail stack.
- [Events](https://trophy-mintlify-04769b11.mintlify.app/features/events.md): Send Trophy Events from your app to record user interactions, update metrics, and automatically trigger achievements, streaks, points, and leaderboards.
- [Leaderboards](https://trophy-mintlify-04769b11.mintlify.app/features/leaderboards.md): Add competitive Trophy Leaderboards to your product to rank users by points, streaks, or custom metrics across daily, weekly, and all-time windows.
- [Metrics](https://trophy-mintlify-04769b11.mintlify.app/features/metrics.md): Model any user interaction as a Trophy Metric and automatically drive achievements, streaks, points, and leaderboards from a handful of API calls.
- [Overview](https://trophy-mintlify-04769b11.mintlify.app/features/overview.md): Learn the key Trophy concepts—metrics, events, achievements, streaks, points, and leaderboards—that power gamified web and mobile product experiences.
- [Points](https://trophy-mintlify-04769b11.mintlify.app/features/points.md): Build points and XP systems with Trophy, including triggers, multipliers, boosts, and level progression to reward user actions inside your product.
- [Push Notifications](https://trophy-mintlify-04769b11.mintlify.app/features/push-notifications.md): Send gamification push notifications from Trophy for achievements, streak reminders, points, and level-ups across your iOS and Android user base.
- [Streaks](https://trophy-mintlify-04769b11.mintlify.app/features/streaks.md): Add daily, weekly, or custom-frequency Trophy Streaks to your product to drive habit-forming behavior, retention, and long-term user engagement.
- [Users](https://trophy-mintlify-04769b11.mintlify.app/features/users.md): Track Trophy Users across your product to attribute events, store attributes, and personalize achievements, streaks, points, and leaderboard rankings.
- [Welcome to Trophy](https://trophy-mintlify-04769b11.mintlify.app/getting-started/introduction.md): Trophy documentation for gamification APIs—quickstart guides, SDK references, tutorials, and feature docs for achievements, streaks, points, and more.
- [Quick Start](https://trophy-mintlify-04769b11.mintlify.app/getting-started/quickstart.md): Get up and running with Trophy in under 10 minutes: install an SDK, identify a user, send your first event, and trigger an achievement in your product.
- [How to Build a Gamified Fitness Tracker](https://trophy-mintlify-04769b11.mintlify.app/guides/gamified-fitness-platform.md): Build a Strava-style gamified fitness tracker with Next.js and Trophy, including multi-sport tracking, city leaderboards, and normalized XP progression.
- [Environments](https://trophy-mintlify-04769b11.mintlify.app/platform/environments.md): Use Trophy environments to test and review gamification changes in development or staging before releasing achievements, streaks, and points to production.
- [Experimentation](https://trophy-mintlify-04769b11.mintlify.app/platform/experimentation.md): Run controlled experiments on Trophy gamification features—achievements, streaks, points, and emails—to increase retention and user engagement over time.
- [Multi-Tenancy](https://trophy-mintlify-04769b11.mintlify.app/platform/multi-tenancy.md): Use Trophy multi-tenancy to set up and customize gamification features per customer, organization, or workspace inside your B2B SaaS product.
- [Overview](https://trophy-mintlify-04769b11.mintlify.app/platform/overview.md): Configure and operate the Trophy platform across environments, multi-tenant workspaces, experimentation, and team access for your gamification stack.
- [Achievement completed](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/achievements/achievement-completed.md): Triggered when a user completes an achievement.
- [Leaderboard changed](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/leaderboards/leaderboard-changed.md): Triggered when leaderboard rankings change.
- [Leaderboard finished](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/leaderboards/leaderboard-finished.md): Triggered when a run of a leaderboard finishes.
- [Leaderboard rank changed](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/leaderboards/leaderboard-rank-changed.md): Triggered when a user's leaderboard rank changes.
- [Leaderboard started](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/leaderboards/leaderboard-started.md): Triggered when a run of a leaderboard begins.
- [Points boost finished](https://trophy-mintlify-04769b11.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-04769b11.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-04769b11.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-04769b11.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-04769b11.mintlify.app/webhooks/events/streaks/streak-extended.md): Triggered when a user extends an existing active streak.
- [Streak freeze consumed](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/streaks/streak-freeze-consumed.md): Triggered when a user consumes a streak freeze.
- [Streak freeze earned](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/streaks/streak-freeze-earned.md): Triggered when a user earns streak freezes.
- [Streak lost](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/streaks/streak-lost.md): Triggered when a user loses their streak.
- [Streak started](https://trophy-mintlify-04769b11.mintlify.app/webhooks/events/streaks/streak-started.md): Triggered when a user starts a streak.
- [Idempotency](https://trophy-mintlify-04769b11.mintlify.app/webhooks/idempotency.md): Ensure your Trophy webhook endpoints process each event exactly once using delivery IDs and idempotency keys to prevent duplicate side effects.
- [Introduction](https://trophy-mintlify-04769b11.mintlify.app/webhooks/introduction.md): Use Trophy webhooks to receive real-time events for achievements, streaks, points, and level changes, and power custom gamification integrations.
- [Observability](https://trophy-mintlify-04769b11.mintlify.app/webhooks/observability.md): Monitor, debug, and diagnose Trophy webhook delivery using the dashboard event log, attempt history, response payloads, and per-endpoint health metrics.
- [Quick Start](https://trophy-mintlify-04769b11.mintlify.app/webhooks/quickstart.md): Start receiving Trophy webhook events for achievements, streaks, and points in under 10 minutes by creating an endpoint and verifying your first delivery.
- [Retries](https://trophy-mintlify-04769b11.mintlify.app/webhooks/retries.md): Understand how Trophy retries failed webhook deliveries with exponential backoff, manual replay, and configurable endpoint behavior for reliable delivery.
- [Security](https://trophy-mintlify-04769b11.mintlify.app/webhooks/security.md): Build secure Trophy webhook endpoints using HMAC signature verification, replay protection, and best practices to confirm payloads come from Trophy.

## OpenAPI Specs

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