Confluence Cloud as your first Atlassian integration

📘

Important

This guide walks you through how to set up Confluence Cloud if you haven't already connected to Jira Cloud, Jira Core Cloud, Jira Software Cloud or Jira Service Desk Cloud.

If you have already connected with any of those apps, please see: Confluence Cloud as an additional Atlassian integration.

Confluence Cloud's Guide: https://developer.atlassian.com/cloud/confluence/
Authorization protocol: OAuth 2.0

1. Add the Confluence Cloud connector in the Xkit platform.

• In the Xkit platform, click "New connector" in the sidebar or at the bottom of the "Connectors" screen.
• Click "Confluence Cloud". At this point you'll see a callback URL, which you'll provide to Confluence Cloud in one of the following steps, and places to input the Client ID and Client Secret that you'll get from Confluence Cloud after registering your app with them.

2. Register your application with Confluence.

• Next, in a separate window, sign in to your Confluence/Atlassian account or create an account if you don't have one.
• Visit this link: https://developer.atlassian.com/apps/
• Click "Create new app". Enter the name of your application, check the box to agree to the terms, and click "Create".

3. Provide Xkit with the credentials.

• After completing the last step, you should have been taken to a screen that shows your Client ID and Secret.
• Copy/paste your Client ID and Secret onto the Xkit page.
• If you like, you can also enter a description of your app and your logo on this page.

4. Provide Confluence Cloud with the callback url.

• Click "OAuth 2.0 (3LO)" in the sidebar.
• Copy/paste the callback URL from the Xkit platform into the "Callback URL" field on the Confluence Cloud page.
• Click "Save changes".

5. Add the Confluence Cloud API.

• After saving changes in the last step, you will see a message that says "Your app doesn't have any APIs. Add APIs to your app." Click the "Add APIs" link.
• Under "Confluence API", click "Add".

6. Select the required permissions.

• Again under "Confluence API", click "Configure".
• Click "Add" next to your required scopes (additional details about the scopes are available here).

7. Complete the Xkit connection setup.

• Now that you've provided the callback URL to Confluence Cloud and entered the Client ID and Client Secret into the Xkit platform, click "Save" on the Xkit page.
• Fill out the Catalog Settings page and again click "Save".
• On the next page, select the same permissions/scopes you entered into Confluence Cloud and click "Save".

You've now successfully connected Confluence Cloud with Xkit!