Markdown Importer REST API

api

The Markdown Importer REST API allows you to programmatically import markdown content into Confluence pages. This feature is designed for automation workflows, CI/CD pipelines, bulk migrations, and custom integrations.

Key Features

Secure Authentication: JWT-based token authentication
Automatic Conversion: Markdown to Confluence ADF (Atlas Document Format)
Conflict Handling: Create new pages or update existing ones
License Validation: Tied to your active Confluence license
Audit Logging: Complete request logging for security and debugging

Prerequisites

Active Markdown Importer for Confluence license
Admin access to Confluence global settings
HTTPS-enabled environment for secure API calls

Documentation Sections

Explore the REST API documentation:

Getting Started - Set up API tokens and make your first request
Authentication - Token management and security
API Reference - Endpoints, request/response formats
Limitations - API usage limits and constraints
Examples - Code samples in multiple languages
Best Practices - Security, performance, and error handling
Troubleshooting - Common issues and solutions
FAQ - Frequently asked questions

Quick Start

Navigate to Confluence Settings → Apps → Markdown Importer for Confluence → API tab
Click Create New Token and configure expiration
Copy your token (you won't see it again!)
Make your first API request:

curl -X POST "YOUR_API_ENDPOINT" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceId": "DOCS",
    "parentId": "123456789",
    "pageTitle": "My First API Page",
    "content": "# Hello World\n\nThis is my first API-created page!",
    "overwrite": false
  }'

Support

Support Portal: https://inuyasi.atlassian.net/servicedesk/customer/portal/1
Product Documentation: https://inuyasi.com/docs/markdown-importer-for-confluence
Marketplace: https://marketplace.atlassian.com

Document Version: 1.0 Last Updated: 2025-10-07 Product: Markdown Importer for Confluence