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.

Step 2: Generate an API Token

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

Step 3: Find Your Organization ID

Go to admin.atlassian.com
Select your organization
The Organization ID appears in the URL: admin.atlassian.com/o/<org-id>/...
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