API Token

Setup
Reference

What You'll Need

Credential	What it is
API Token	Generated from Atlassian account settings
Email Address	Your Atlassian account email
Base URL	e.g., `https://your-company.atlassian.net`

Overview

Connect Parable to Confluence Cloud. API token authentication uses Basic Auth with your Atlassian email and a generated token for secure, automated API access.

Prerequisites

Administrator Access

You need Confluence Administrator or Space Administrator role to access comprehensive data.

Required Permissions

Access Level	Required For
Space Administrator	Full space access, user activity
Confluence Administrator	All spaces, comprehensive user data
View permission	Reading pages in specific spaces

Setup Guide

Generate API Token

Visit Atlassian API Tokens
Click Create API token
Label it: Parable Confluence Integration
Set an appropriate expiration date
Click Create

Copy your now!This is the only time it will be displayed. Store it in a secure password manager before closing this page.

Gather Instance Details

Field	Where to Find It
Instance URL	Browser address bar: `your-company.atlassian.net`
Your Email	The email you sign in with

Enter values in the form

Enter Email, API Token, and Base URL in the connector form.
Click Save & test connection.

Verify Your Setup

The API uses Basic authentication. Combine your credentials and Base64 encode them:

username:password  →  Base64 encode  →  Authorization: Basic {encoded}

# The -u flag handles Base64 encoding automatically
curl -X GET "https://your-company.atlassian.net/wiki/api/v2/users?limit=1" \
  -u "your-email@company.com:YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests
import base64

# Encode credentials
credentials = "your-email@company.com:YOUR_API_TOKEN"
encoded = base64.b64encode(credentials.encode()).decode()

response = requests.get(
    "https://your-company.atlassian.net/wiki/api/v2/users?limit=1",
    headers={
        "Authorization": f"Basic {encoded}",
        "Content-Type": "application/json"
    }
)
print(response.json())

For , use your email address as the username and the API token as the password.

Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.

API Endpoints Reference

Users

GET /wiki/api/v2/users

Parameters: start, limit (max 100), accountId

Pages

GET /wiki/api/v2/pages

Parameters: start, limit, spaceKey, expand (body, version, space, history)

Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

Troubleshooting

Error	Meaning	Solution
401 Unauthorized	Invalid credentials	Check email and API token
403 Forbidden	Insufficient permissions	Verify user has admin privileges
429 Too Many Requests	Rate limit exceeded	Implement exponential backoff

Permission Errors

If you encounter permission errors:

Verify the user has appropriate space permissions
For user data access, ensure the user has admin privileges
For activity data, confirm the user has Confluence Administrator role

Additional Resources

Confluence REST API v2

Official API documentation

Release Notes

Connectors

What You'll Need

Overview

Prerequisites

Setup Guide

Verify Your Setup

API Endpoints Reference

Users

Pages

Troubleshooting

Additional Resources

Confluence REST API v2

What You'll Need

​Overview

​Prerequisites

​Setup Guide

​Verify Your Setup

​API Endpoints Reference

​Users

​Pages

​Troubleshooting

​Additional Resources

Confluence REST API v2

Overview

Prerequisites

Setup Guide

Verify Your Setup

API Endpoints Reference

Users

Pages

Troubleshooting

Additional Resources