nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Does confluence Cloud supports Webhooks?

kuldeep kushwaha

I have created confluence access token using the below-mentioned link,
https://developer.atlassian.com/cloud/jira/platform/oauth-2-authorization-code-grants-3lo-for-apps/

As per Atlassian Webhook Docs mentioned below
https://developer.atlassian.com/cloud/confluence/modules/webhook/

Confluence supports webhooks but URL to create webhook is not mentioned properly in the documentation.
Can you please help me with Url and parameters.

Accepted answers

Shannon S

Hello @kuldeep kushwaha,

Confluence Cloud does have Webhooks, as you have already discovered. However, Confluence does not have a Webhook administration page as in Jira. We have the below feature request for this:

CONFCLOUD-36613 Allow Confluence Webhook Administration

Webhooks can be registered through the descriptor file in Confluence Cloud as mentioned on this thread from our Developer Community, Are webhooks available to add-ons in Confluence Server.

In case you have any further questions about this, I advise you to raise a question on the Developer Community that I linked above. Be advised that the regular Atlassian Community is focused on end-users, so you're more likely to find the help you need from the Developer Community.

Regards,

Shannon

Dario B

Hello @kuldeep kushwaha ,

Allow me to step in and try to summarize everything that has been said till now.

However, before going any further, I'd like to also try to make clear that this is not the best place to ask development related questions. The right resources are listed in https://developer.atlassian.com/resources:

Once this has been said:

In Confluence Cloud Webhooks can only be registered through the descriptor file of an add-on, not from the UI
There is an open feature request to ask for the possibility to manage Webhooks through the UI: [CONFCLOUD-36613] Allow Confluence Webhook Administration
The frameworks to create an add-on for Confluence Cloud, including nodejs, are listed in this page: Frameworks and Tools
Having the right skillset it should be quite easy to build a simple add-on that will just register some Webhooks that will send data to the desired endpoint in WebMethods in case of any update in Confluence Cloud.
Once registered, Webhooks should be triggered almost immediately when the desired/configured events were fired. I am not sure what you mean with "instant updates". Can you provide more details on this?
If you need further help with this you may want to ask in the developers community rather than in here: https://community.developer.atlassian.com/

I hope this clarifies.

Cheers,
Dario

All comments

Shannon S

Hello @kuldeep kushwaha,

Confluence Cloud does have Webhooks, as you have already discovered. However, Confluence does not have a Webhook administration page as in Jira. We have the below feature request for this:

CONFCLOUD-36613 Allow Confluence Webhook Administration

Webhooks can be registered through the descriptor file in Confluence Cloud as mentioned on this thread from our Developer Community, Are webhooks available to add-ons in Confluence Server.

Regards,

Shannon

kuldeep kushwaha

Hi,
Can we create Confluence plugin using node js if so can you please provide me with the link.

And can Confluence plugins act as webhooks and provide me with the latest update.

Regards
Kuldeep Kushwaha

Shannon S

Kuldeep,

Yes, you can! Here's the documentation below:

Getting Started on Confluence Cloud development

If you have any questions regarding this, please reach out to the Developer Community instead; they will be able to answer any questions for you related to developing for Atlassian products.

Regards,

Shannon

kuldeep kushwaha

Hi,

I want to integrate confluence with our product webMethods.io Integration in the same was as slack is integrated with confluence.
Any changes made in confluence is notified to me on our notification url can we achieve this through macro.

I asked the same query on the Atlassian community.
https://community.atlassian.com/t5/Confluence-questions/Want-to-create-addon-integrate-webMethods-io-to-receive/qaq-p/1237238

The above link provided by you explains how to create macros but can I achieve instant notification updates by using macros.

Could you please help me with this.

Regards
Kuldeep Kushwaha

Dario B

Hello @kuldeep kushwaha ,

Allow me to step in and try to summarize everything that has been said till now.

Once this has been said:

In Confluence Cloud Webhooks can only be registered through the descriptor file of an add-on, not from the UI
There is an open feature request to ask for the possibility to manage Webhooks through the UI: [CONFCLOUD-36613] Allow Confluence Webhook Administration
The frameworks to create an add-on for Confluence Cloud, including nodejs, are listed in this page: Frameworks and Tools
Having the right skillset it should be quite easy to build a simple add-on that will just register some Webhooks that will send data to the desired endpoint in WebMethods in case of any update in Confluence Cloud.
Once registered, Webhooks should be triggered almost immediately when the desired/configured events were fired. I am not sure what you mean with "instant updates". Can you provide more details on this?
If you need further help with this you may want to ask in the developers community rather than in here: https://community.developer.atlassian.com/

I hope this clarifies.

Cheers,
Dario

webmethods-integration

HI @Dario B @Shannon S

Using the app descriptor file I am able to register webhook in Confluence Cloud and able to receive the JSON data as soon as an event is performed in Confluence.
But I noticed that the user who is within the administrator group was able to set webhook and other users were not.
I searched for the same but didn't find anything on Confluence Documentation.
So is there any restrictions with scopes regarding Webhook setup. If yes can you please provide me with the document link.

Regards,

Kuldeep Kushwaha

Dario B

Hello @webmethods-integration ,

It is pretty normal that only admin can create webhooks and this is actually the same in Jira. Indeed, the page to create webhooks is in the Jira administration section (not accessible to non-admin users).

If it wouldn't be this way, a malicious user would be able to create webhooks to send sensitive/private data to remote resources.

Also, for the future, please try to avoid adding questions to threads that are already 7 months old. Create a new thread instead.

Have a nice weekend.

Cheers,
Dario

Vadim Rutkevich_4dwnfh

Hi @kuldeep kushwaha !

You can try to use Webhook Manager for Confluence Cloud. It provides an easy way to manage and administer Confluence webhooks.

Thanks.

Sincerely, Vadim [StiltSoft]

Earl McCutcheon

Hi All,

@Dario B just added a new workaround to the CONFCLOUD-36613 feature request that I am reposting below to make sure it gets extra visibility, hope this helps y'all out:

Workaround

WARNING!

There is one security concern regarding webhooks created using the way explained below: even though they can only be created by admins, there are no other permissions checks. If a regular user creates a restricted page, admins won't be able to access it via Confluence UI/API, but they will be able to receive webhooks related to this page. The information of course is very limited, but they will be able to see a title of a page, for example. We fixed this for regular webhooks a couple of years ago, but here it's not possible since there is no user to check permissions against.

There exists a private API that can be used for this purpose. However, the endpoint discussed below is intended for internal use only. Therefore, it is not part of the official Confluence Cloud REST APIs, it is not supported and it can change without any notice.

Once this has been said: you can register, list or delete Webhooks in Confluence Cloud by using the internal REST API endpoint /wiki/rest/webhooks/1.0/webhook.

The endpoint works the same way as the /rest/webhooks/1.0/webhook endpoint documented for Jira Cloud in the Webhook documentation page, section: Registering a webhook using the Jira REST API (Other integrations)

To register a webhook using REST:

Send a POST request using below format to: https://your-domain.atlassian.net/wiki/rest/webhooks/1.0/webhook

{
  "name": "Webhook (test comment created)",
  "url": "https://www.example.com/webhooks",
  "events": [
    "comment_created"
  ]
}

The response will return the webhook in JSON with additional information, including the user that created the webhook, the created timestamp, etc.

For a complete list of events, etc, please refer to the Confluence Cloud Webhook documentation page.

To unregister (that is, delete) a webhook using REST:

Execute a DELETE to the following URL: https://your-domain.atlassian.net/wiki/rest/webhooks/1.0/webhook/<Webhook-ID>

Example:
The following would delete the webhook with an ID of 70:

curl --user EmailAddress:ApiToken -X DELETE -H "Content-Type: application/json" https://your-domain.atlassian.net/wiki/rest/webhooks/1.0/webhook/70

To query a webhook using REST:

To get all webhooks (registered using this method) for a Confluence Cloud site, send a GET request to: https://your-domain.atlassian.net/wiki/rest/webhooks/1.0/webhook.

Example:

curl --user EmailAddress:ApiToken -X GET -H "Content-Type: application/json" https://your-domain.atlassian.net/rest/webhooks/1.0/webhook

To get a specific webhook by its ID, perform a GET with the following URL: https://your-domain.atlassian.net/rest/webhooks/1.0/webhook/<Webhook-ID>

Example: the following would get a webhook with an ID of 72

curl --user EmailAddress:ApiToken -X GET -H "Content-Type: application/json" https://your-domain.atlassian.net/rest/webhooks/1.0/webhook/72

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

cloud

api

confluence-cloud

webhook

confluence-development