Confluence

Configuration

Confluence source connector integrates with the Confluence REST API to extract content.

Connects to your Confluence instance.

It supports syncing spaces, pages, blog posts, comments, labels, and other content types. It converts Confluence pages to HTML format for content extraction and extracts embedded files and attachments from page content.

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Graffo UI or API using the OAuth flow.

Supported authentication methods:

• OAuth Browser Flow (recommended for UI)

• OAuth Token (for programmatic access)

• Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

ConfluenceSpaceEntity

Schema for a Confluence Space.

Reference: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-spaces/

Field	Type	Description
space_id	str	Unique identifier for the space.
space_name	str	Display name of the space.
space_key	str	Unique key for the space.
space_type	Optional[str]	Type of space (e.g. 'global').
description	Optional[str]	Description of the space.
status	Optional[str]	Status of the space if applicable.
homepage_id	Optional[str]	ID of the homepage for this space.
site_url	Optional[str]	Base Confluence site URL.

ConfluencePageEntity

Schema for a Confluence Page.

Pages are treated as FileEntity with HTML body saved to local file. Content is not stored in entity fields, only in the downloaded file.

Reference: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-pages/

Field	Type	Description
content_id	str	Actual Confluence page ID.
title	str	Title of the page.
space_id	Optional[str]	ID of the space this page belongs to.
space_key	Optional[str]	Key of the space this page belongs to.
body	Optional[str]	HTML body or excerpt of the page.
version	Optional[int]	Page version number.
status	Optional[str]	Status of the page (e.g., 'current').
site_url	Optional[str]	Base Confluence site URL.

ConfluenceBlogPostEntity

Schema for a Confluence Blog Post.

Reference: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-blog-posts/

Field	Type	Description
content_id	str	Actual Confluence blog post ID.
title	str	Title of the blog post.
space_id	Optional[str]	ID of the space this blog post is in.
space_key	Optional[str]	Key of the space this blog post is in.
body	Optional[str]	HTML body of the blog post.
version	Optional[int]	Blog post version number.
status	Optional[str]	Status of the blog post (e.g., 'current').
site_url	Optional[str]	Base Confluence site URL.

ConfluenceCommentEntity

Schema for a Confluence Comment.

Reference: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-comments/

Field	Type	Description
comment_id	str	Unique identifier for the comment.
parent_content_id	Optional[str]	ID of the content this comment is attached to.
parent_space_key	Optional[str]	Key of the space the parent content belongs to.
text	str	Text/HTML body of the comment.
created_by	Optional[Dict[str, Any]]	Information about the user who created the comment.
status	Optional[str]	Status of the comment (e.g., 'current').
site_url	Optional[str]	Base Confluence site URL.

ConfluenceDatabaseEntity

Schema for a Confluence Database object.

Note: The "database" content type in Confluence Cloud.

Field	Type	Description
content_id	str	Actual Confluence database ID.
title	str	Title or name of the database.
space_key	Optional[str]	Space key for the database item.
description	Optional[str]	Description or extra info about the DB.
status	Optional[str]	Status of the database content item.

ConfluenceFolderEntity

Schema for a Confluence Folder object.

Note: The "folder" content type in Confluence Cloud.

Field	Type	Description
content_id	str	Actual Confluence folder ID.
title	str	Name of the folder.
space_key	Optional[str]	Key of the space this folder is in.
status	Optional[str]	Status of the folder (e.g., 'current').

ConfluenceLabelEntity

Schema for a Confluence Label object.

Reference: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-labels/

Field	Type	Description
label_id	str	Unique identifier for the label.
label_name	str	Display name of the label.
label_type	Optional[str]	Type of the label (e.g., 'global').
owner_id	Optional[str]	ID of the user or content that owns label.
site_url	Optional[str]	Base Confluence site URL.

ConfluenceTaskEntity

Schema for a Confluence Task object.

For example, tasks extracted from Confluence pages or macros.

Field	Type	Description
task_id	str	Unique identifier for the task.
content_id	Optional[str]	The content ID (page, blog, etc.) that this task is associated with.
space_key	Optional[str]	Space key if task is associated with a space.
text	str	Text of the task.
assignee	Optional[Dict[str, Any]]	Information about the user assigned to this task.
completed	bool	Indicates if this task is completed.
due_date	Optional[Any]	Due date/time if applicable.

ConfluenceWhiteboardEntity

Schema for a Confluence Whiteboard object.

Note: The "whiteboard" content type in Confluence Cloud.

Field	Type	Description
whiteboard_id	str	Unique identifier for the whiteboard.
title	str	Title of the whiteboard.
space_key	Optional[str]	Key of the space this whiteboard is in.
status	Optional[str]	Status of the whiteboard (e.g., 'current').

ConfluenceCustomContentEntity

Schema for a Confluence Custom Content object.

Note: The "custom content" type in Confluence Cloud.

Field	Type	Description
custom_content_id	str	Unique identifier for the custom content.
title	str	Title or name of this custom content.
space_key	Optional[str]	Key of the space this content resides in.
body	Optional[str]	Optional HTML body or representation.
status	Optional[str]	Status of the custom content item (e.g., 'current').