Connecting Confluence to action builder
Before you can include external actions in your action flows, you must connect the action builder to the external system.
- All external actions performed by an action flow are attributed to the user who connected the external system. Therefore, it is a best practice to use a dedicated service account rather than personal credentials when connecting to each external system.
- All integrations request access to necessary scopes. However, it's important that you review and validate the scopes before authorizing the connection to the external system.
- When managing credentials for API key-based tools, such as OpenAI, it's best to store keys in a secure vault or credential manager.
- In Admin Center, click
Apps and integrations in the sidebar, then select Actions > Action flows. - Create or edit an action flow.
- Open the step sidebar.
- Under External actions, click Confluence.
- Click Connect.
- Follow Atlassian's prompts to authenticate and complete the
connection.Note: All external actions performed by an action flow are attributed to the user who connected the external system. Therefore, it is a best practice to use a dedicated service account rather than personal credentials when connecting to each external system.
After you've connected to the system, you'll see an indicator that it's connected and details about the instance you're connected to, as well as the actions available for Confluence.
Using Confluence actions in action flows
Confluence action steps can be used to create, update, and add comments to Confluence pages.
Creating a Confluence page
Use the Create page action to create a new Confluence page with the specified title and text-based content.
This action has the following inputs and outputs:
| Variables | |
|---|---|
| Inputs |
space_id, title,
value
|
| Output | Full metadata |
Updating an existing Confluence page
Use the Update page action to update an existing Confluence page with specified text-based changes.
This action has the following inputs and outputs:
| Variables | |
|---|---|
| Inputs |
space_id, title,
value
|
| Output | Full metadata |
Creating a footer comment on an existing Confluence page
Use the Create footer comment action to add a comment to an existing Confluence page.
This action has the following inputs and outputs:
| Variables | |
|---|---|
| Inputs |
page_id, value
|
| Output |
id, status
|
Searching for a Confluence page
Use the Search for a page action to search for a Confluence page by its title.
This action has the following inputs and outputs:
| Variables | |
|---|---|
| Inputs | title |
| Output |
id, title
|