Set up a connection to Confluence Cloud

Confluence Cloud is a project management and enterprise wiki tool that helps teams organize and manage collective content, and collaborate on projects.

Confluence Cloud documentation: API guide, Authentication
Additional reference:  Supported Confluence Cloud APIs

Contents

• A. Set up a Confluence Cloud connection
• B. Describe the Confluence Cloud connection
• C. Provide required Confluence Cloud account information
  • Retrieve Confluence Cloud API token
• D. Edit advanced Confluence Cloud settings
• E. Test the connection

A. Set up a Confluence Cloud connection.

Start establishing a connection to Confluence Cloud in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select Confluence Cloud.

The Create connection panel opens with required and advanced settings.

B. Describe the Confluence Cloud connection

Edit the General settings specific to your account and this connection resource.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing. 

C. Provide required Confluence Cloud account information

At this point, you’re presented with a series of options for providing Confluence Cloud authentication.

Instance URL (required): Enter your Confluence Cloud instance URL. For example, if https://demo.atlassian.net/wiki/home is your instance, then type demo.atlassian.net for this setting.

Username (required): Enter the username of your Confluence Cloud account.

API token (required): Enter the API token provided to you by Confluence Cloud. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s API token safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

Retrieve Confluence Cloud API token

1. Sign in to your Confluence Cloud account.

2. Navigate to Profile > Manage your account > Security > API Token > Create and Manage API tokens.

3. Click Create API token; to generate a new token. The Create an API token panel opens.
4. Enter the Label name.
5. Click Create.
6. Copy the new API token.

Important: If you do not copy your new API token, you cannot see the token again.

D. Edit advanced Confluence Cloud settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Confluence Cloud connection.

Borrow concurrency from (optional): Select another connection from the list. By default, all data flowing through a connection record is submitted to the respective endpoint application at the Concurrency level configured for that connection record. There are cases, however, where multiple integrator.io connections need to share the same concurrency level, and this field allows you to specify which connection you would like to borrow from. With borrowed concurrency, the data flowing through both connections will be submitted to the endpoint application together, via a shared concurrency model.

Note: Selecting another app changes form...

Concurrency level (optional): Up to 25 allowed...

E. Test the connection

Once you have configured the Confluence Cloud connection, you have a few options for continuing:

• Save – click to test the connection, commit the new connection so that it will be available to all integrations for your account
• Save & close – click to test and save the connection and exit the Create connection panel
• Close – click to exit without saving any new changes
• Test connection – click this button to verify that your new connection is free of errors

When you test or save the connection, it is verified before continuing. 

The new connection is now successfully added to your account. It will be applied to the current source or destination app if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.