​

What’s Supported

​

Supported Actions

For Jira, the following is supported:

• Read Actions, including full historic backfill and incremental read.
• Write Actions.
• Proxy Actions, using the base URL https://api.atlassian.com.

​

Supported Objects

The Atlassian connector supports writing to and reading from Jira Issues.

​

Example Integration

For an example manifest file of a Jira integration, visit our samples repo on Github.

​

Before You Get Started

To integrate Atlassian Jira with Ampersand, you will need an Atlassian Account.

Once your account is created, you’ll need to create an app in Atlassian, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

• Client ID
• Client Secret
• Scopes

You will then use these credentials and scopes to connect your application to Ampersand.

​

Create an Atlassian Account

Here’s how you can sign up for an Atlassian account:

• Go to the Atlassian Sign Up page and create an account.
• Sign up using your preferred method.

​

Creating an Atlassian App

Follow the steps below to create an Atlassian app:

1. Go the Atlassian Developer Console My Apps Page.

2. Click the Create dropdown to create a new app.

3. Select Oauth 2.0 integration.

4. Enter the App Name.

5. Select the I agree to be bound by Atlassian’s developer terms. checkbox.

6. Click Create.

   
   

​

Adding Scopes in your Atlassian App

You need to define the necessary permissions for your Atlassian app by selecting and adding required scopes, to allow Ampersand to access data effectively. You can limit the access to only the specific scopes needed for your application.

Follow the steps below to add scopes to your Atlassian App:

1. In the Atlassian Developer Console My Apps Page, select your app.
2. Go to Permissions.
3. Select the scopes for your application. Atlassian will authorize access to the selected scopes for your application.

For more information on the scopes, go to Scopes section in the Atlassian documentation.

​

Adding Ampersand Redirect URL in Your App

Follow the steps below to add the Ampersand redirect URL in your Atlassian app:

1. In the Atlassian Developer Console My Apps Page, select your app.
2. Go to Authorization.
3. Next to OAuth 2.0 (3LO), click Add.
4. Enter the Ampersand Callback URL: https://api.withampersand.com/callbacks/v1/oauth.
5. Click Save changes.

You’ll find the Client ID and Client Secret keys for your app in the Settings section.

You’ll use these credentials while connecting your app to Ampersand.

​

Add Your Atlassian App Info to Ampersand

1. Log in to your Ampersand Dashboard.

2. Select the project where you want to create a Atlassian integration.

3. Select Provider apps.

4. Select Atlassian from the Provider list.

5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.

6. Enter the scopes set for your application in Atlassian. In addition to the scopes you configured, you must add the offline_access scope.

7. Click Save changes.

​

Using the connector

To start integrating with Atlassian:

• Create a manifest file like the example.
• Deploy it using the amp CLI.
• If you are using Read Actions, create a destination.
• Embed the InstallIntegration UI component.
• Start using the connector!
  • If your integration has Read Actions, you’ll start getting webhook messages.
  • If your integration has Write Actions, you can start making API calls to our Write API.
  • If your integration has Proxy Actions, you can start making Proxy API calls.