--- title: Atlassian API Integration on Truto slug: atlassian category: Default canonical: "https://truto.one/integrations/detail/atlassian/" --- # Atlassian API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Activities** — Activities are the actions performed by users in the source application. - **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 - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ## How it works 1. **Link your customer's Atlassian 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 Atlassian.** The Proxy API is a 1-to-1 mapping of the Atlassian 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 - **Automate employee onboarding and offboarding in Atlassian** — HR and IT orchestration platforms can use Truto's Unified User Directory API to provision new hires into the right Atlassian workspaces, groups, and licenses on day one — and revoke access instantly on departure, reducing security risk and license waste. - **Sync identity and group data across SaaS tools** — Identity governance and SaaS management platforms need a single view of who has access to what. Pulling users, groups, and license assignments from Atlassian lets these platforms map identities across every tool in a customer's stack. - **Monitor user activity for compliance and security** — Security and compliance SaaS products can read Atlassian user activity data to detect anomalous logins, enforce access policies, and generate audit-ready reports — critical for customers in regulated industries. - **Manage Atlassian license costs programmatically** — SaaS spend management and IT finance platforms can read license and user data from Atlassian organizations to identify unused seats, flag over-provisioning, and help customers optimize their Atlassian spend. ## What you can build - **Automated Atlassian user provisioning** — Create users in a customer's Atlassian workspace and assign them to the correct groups and licenses based on role data from your platform. - **Cross-platform identity directory** — Pull all users, groups, and workspace memberships from Atlassian alongside other SaaS tools to build a unified org chart and access map. - **License utilization dashboard** — Read Atlassian license assignments and user activity to surface unused or underutilized seats so customers can right-size their subscriptions. - **Offboarding access revocation workflow** — Automatically remove departing employees from Atlassian groups and revoke their licenses as part of a broader IT offboarding automation. - **User activity audit log feed** — Stream Atlassian user activity data into your security or compliance product for real-time monitoring and historical audit trails. - **Organization-level workspace inventory** — Enumerate all workspaces and organizations a customer manages in Atlassian to give IT admins a complete picture of their Atlassian footprint. ## FAQs ### What Atlassian data can I access through Truto's Unified User Directory API? The Unified User Directory API exposes Activities, Groups, Licenses, Organizations, Users, and Workspaces. These map to Atlassian's organization and admin-level APIs, giving you the identity and access data needed for provisioning, compliance, and license management workflows. ### How does authentication work for Atlassian integrations through Truto? Truto handles OAuth 2.0 (3LO) flows for Atlassian Cloud. Your end users authorize access through a managed consent screen, and Truto stores and refreshes tokens automatically — you never need to manage credentials directly. ### Does Truto handle Atlassian API rate limits? Yes. Truto manages pagination and respects Atlassian's rate limit headers automatically, so your integration won't hit 429 errors or need custom retry logic. ### Can I access Jira issues or Confluence pages through this integration? The currently available Unified API for Atlassian is the User Directory API, which covers identity and access data. Ticketing and project management capabilities (like Jira issues) are not yet mapped but can be built on request — reach out to the Truto team to discuss your specific use case. ### What if I need a specific Atlassian API endpoint that isn't covered by the Unified User Directory API? Truto builds integrations on request. If you need access to additional Atlassian endpoints — such as Jira issue CRUD, Confluence content, or Bitbucket repositories — the Truto team can add support tailored to your requirements. ### Does Truto support both Atlassian Cloud and Atlassian Data Center (on-premise)? Truto's Atlassian integration is designed for Atlassian Cloud, which uses the REST and Admin APIs. If you have customers on Atlassian Data Center, contact the Truto team to discuss feasibility for your specific deployment scenario.