# Atlassian

Atlassian provides collaboration and productivity tools including Jira, Confluence, and Trello that help teams plan, track, and deliver projects efficiently.

## Overview

The Atlassian connector allows you to list and query organizations, users in organizations and audit logs.

## Authentication

To authenticate with Atlassian you will need to generate a new API key. Instructions can be found [here](https://confluence.atlassian.com/cloud/create-an-admin-api-key-969537932.html) on how to generate this token.
**It's important to note that when generating a key, the default expiration date of this token is 7 days. We recommend that you change this to the maximum which is a year. This will mean that you will still have to reauthenticate when the token is due to expire.**
![change-date](https://tray.ai/documentation/images/connectors/service/atlassian/39ad87ca-38d04564_docs-change-date.png)
Once an API key has been generated on Atlassian. Log in to tray.io, create a workflow and drag in the Atlassian connector. From the input panel click on the `New authentication` button
![add-auth](https://tray.ai/documentation/images/connectors/service/atlassian/39ad87ca-550b03d3_../../../../../images/add-auth.png)
You can then name your authentication and in the API Key field provide the API key that was generated by Atlassian.
![rename\_auth](https://tray.ai/documentation/images/connectors/service/atlassian/39ad87ca-a453dfa1_atlassian-docs-name-auth.png)
Once the API key has been added, click `Add authentication` button. You are now set up and ready to use the Atlassian connector.

## Note on Operations usage

> **Warning:** **IMPORTANT!**: Please note that the Confluence
> are under the
> .

This means that in the Confluence connector, when you want to list the users of confluence, you have to use an Atlassian connector in order to get them.
The Atlassian connector itself *requires a different authentication process*, one which requires you to have access to a 'Super API Key' (as detailed above).