Getting Started

​

Step 1: Access API Token Management

1. Navigate to Confluence Settings (⚙️ icon in top right)
2. Under Apps, select Markdown Importer for Confluence
3. Click on the API tab in the header

​

Step 2: Create an API Token

1. Click Create New Token
2. Enter a unique label (e.g., production, ci-cd-pipeline, staging)
   • Label requirements:
     • 3-50 characters
     • Letters, numbers, hyphens, and underscores only
     • Must be unique
3. Select an expiration period:
   • 1 Day
   • 3 Days
   • 1 Week
   • 2 Weeks
   • 1 Month (30 days)
4. Click Create Token
5. Important: Copy the token immediately - you won’t be able to see it again!

​

Step 3: Store Your Token Securely

​

Step 4: Find Your API Endpoint

https://yamuno-test.atlassian.net/wiki/apps/ab418ef5-23d6-40b6-bfae-9a9a3c977f32/b2653bbd-8dc5-4398-baf5-bdf02c455308/webtrigger

​

Step 5: Make Your First Request

curl -X POST "$CONFLUENCE_API_ENDPOINT" \
  -H "Authorization: Bearer $CONFLUENCE_API_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!\n\n## Features\n\n- Easy to use\n- Fast deployment\n- Automatic conversion",
    "overwrite": false
  }'

{
  "body": "Success: Page created successfully"
}

​

Next Steps

• Learn about Authentication and security features
• Explore the API Reference for detailed endpoint documentation
• Check out Examples in multiple programming languages
• Review Best Practices for production use