​
Setup Guide

You can find your Confluence app credentials in your Confluence Developer Account.

You’ll need the following information to set up your Confluence App with Paragon Connect:

  • Client ID
  • Client Secret
  • Scopes Requested

​
Add your Confluence app to Paragon

Under Integrations > Connected Integrations > Confluence > Settings, fill out your credentials from your developer app in their respective sections:

  • Client ID: Found under Client ID on your Confluence App page.
  • Client Secret: Found under Client Secret on your Confluence App page.
  • Permissions: Select the scopes you’ve requested for your application. For a list of recommended scopes, please view this integration within your Paragon dashboard. View dashboard.

Leaving the Client ID and Client Secret blank will use Paragon development keys.

​
Connecting to Confluence

Once your users have connected their Confluence account, you can use the Paragon SDK to access the Confluence API on behalf of connected users.

See the Confluence REST API documentation for their full API reference.

Any Confluence API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// Retrieve Pages
paragon.request("confluence", "/wiki/api/v2/pages", {
  method: "GET"
});

// Create a Page
paragon.request("confluence", "/wiki/api/v2/pages", {
  method: "POST",
  body: {
    "spaceId": 15,
    "status": "current",
    "title": "<string>",
    "body": {
      "representation": "storage",
      "value": "<string>"
    }
  }
});

​
Building Confluence workflows

Once your Confluence account is connected, you can add steps to perform the following actions:

  • Create Page
  • Update Page
  • Get Page by ID
  • Get Pages in Space
  • Get Pages by Label
  • Search Pages
  • Delete Page
  • Get Space By ID
  • Search Spaces

You can also the Confluence Request step to access any of Confluence’s API endpoints without the authentication piece.

When creating or updating records in Confluence, you can reference data from previous steps by typing {{ to invoke the variable menu.