--- title: Opsgenie API Integration on Truto slug: opsgenie category: Incident Management canonical: "https://truto.one/integrations/detail/opsgenie/" --- # Opsgenie API Integration on Truto **Category:** Incident Management **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Licenses** — Licenses represent concepts like user seats in apps that support them - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Opsgenie account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Opsgenie.** The Proxy API is a 1-to-1 mapping of the Opsgenie API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync Opsgenie teams and users into your SaaS platform** — Map your customers' Opsgenie users, teams, and roles into your product so you can route internal workflows — like ticket assignments, approval chains, or escalation paths — to the right people without manual configuration. - **Auto-provision users based on Opsgenie team membership** — SaaS companies offering role-based access can pull Opsgenie's user directory to automatically provision accounts and assign permissions, ensuring that on-call engineers and ops teams get the right access from day one. - **Build a unified team directory across incident management tools** — If your product supports multiple incident management platforms, Truto's Unified User Directory API lets you normalize users, groups, and roles from Opsgenie alongside other providers — so your customers get a consistent experience regardless of which tool they use. - **Enrich internal dashboards with Opsgenie organizational data** — Pull Opsgenie user and team data to populate org charts, responsibility matrices, or coverage maps inside your product, giving your users visibility into who owns what without leaving your platform. ## What you can build - **Opsgenie team-to-workspace mapper** — Let your users connect their Opsgenie account and automatically map Opsgenie teams and groups to workspaces or projects in your product for seamless routing. - **User directory sync with role-based access control** — Continuously sync Opsgenie users and their roles into your platform to auto-assign permissions and keep access policies in lockstep with your customer's ops org. - **Cross-platform people search** — Surface a unified search across Opsgenie and other connected user directories so your users can find and assign the right person to a task without switching tools. - **License and seat usage dashboard** — Pull Opsgenie license data via the Unified User Directory API and display it alongside other tools so your customers can track software spend and utilization in one place. - **Group membership change alerts** — Detect when users are added to or removed from Opsgenie teams and trigger workflows in your product — like updating escalation policies or revoking access to sensitive environments. ## FAQs ### What Opsgenie data can I access through Truto today? Opsgenie is supported through Truto's Unified User Directory API, which provides normalized access to Users, Groups, Roles, and Licenses. Additional Opsgenie-specific tools (e.g., Alerts, Schedules, Incidents) are not pre-built but can be built on request to match your use case. ### How does authentication work for Opsgenie integrations? Opsgenie uses API key-based authentication. Your end users generate an API key from their Opsgenie account settings, and Truto securely stores and manages it so you don't have to handle credential storage yourself. ### Are there rate limits I should be aware of with the Opsgenie API? Yes. Opsgenie enforces rate limits that vary by plan — typically around 20-25 requests per second for most endpoints on paid plans. Truto handles retry logic and rate limit backoff automatically so your integration stays resilient. ### Can I request Opsgenie-specific tools beyond the Unified User Directory? Absolutely. Truto builds integration tools on request. If you need access to Opsgenie Alerts, Incidents, Schedules, On-Call data, or Heartbeats, reach out and the Truto team will scope and build the required tools for your use case. ### How does Truto handle pagination for Opsgenie's API? Truto abstracts away Opsgenie's offset-based pagination. When you query Users or Groups through the Unified User Directory API, Truto automatically fetches all pages and returns a complete, normalized result set. ### Can my users connect Opsgenie alongside other incident management or user directory tools? Yes. Truto's Unified User Directory API normalizes data across multiple providers. Your users can connect Opsgenie alongside other supported platforms, and your application receives a consistent data schema regardless of the source.