# How to Connect to Jira Teams

This guide will help you connect your Atlassian organization to Apideck's Unified API via the Jira Teams connector. The Jira Teams connector uses the Atlassian Teams Public API, enabling you to manage teams and members within your Atlassian organization through the Apideck Proxy.

## Prerequisites

Before you begin, make sure you have:

- An active Atlassian account
- Admin access to your Atlassian organization

## How to Get Credentials

### Step 1: Get Your Email

Use the email address associated with your Atlassian account. This is the email you use to log in at [id.atlassian.com](https://id.atlassian.com).

### Step 2: Generate an API Token

1. Go to [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
2. Click **Create API token**
3. Enter a label (e.g., "Apideck Integration") and click **Create**
4. Copy the generated token immediately — it will not be shown again

### Step 3: Find Your Organization ID

1. Go to [admin.atlassian.com](https://admin.atlassian.com)
2. Select your organization
3. The Organization ID appears in the URL: `admin.atlassian.com/o/<org-id>/...`
4. Copy the `<org-id>` value

## Configure in Apideck

### Step 1: Enter Your Credentials

In Apideck Vault, enter the following settings:

- **Email**: Your Atlassian account email address
- **API Token**: The API token generated in Step 2
- **Organization ID**: The org ID found in Step 3

### Step 2: Save the Connection

Click **Save** to establish the connection. Apideck will use these credentials to authenticate requests to the Atlassian Teams Public API via the proxy.

## Troubleshooting

### 401 Unauthorized

If you receive a 401 error:

- Verify the email address is correct (must match your Atlassian account)
- Check that the API token is valid and has not been revoked
- Ensure you copied the full API token without extra spaces

### 403 Forbidden

If you receive a 403 error:

- Confirm the Organization ID is correct
- Ensure your Atlassian account has admin permissions for the organization
- Verify your account has access to the Atlassian Teams Public API

## Additional Resources

- [Atlassian Teams Public API Documentation](https://developer.atlassian.com/cloud/teams/rest/)
- [Apideck Proxy Documentation](https://developers.apideck.com/apis/proxy/reference)