We’re renaming ‘products’ to ‘apps’

Atlassian 'products’ are now ‘apps’. You may see both terms used across our documentation as we roll out this terminology change. Here’s why we’re making this change

Send audit log activities to another tool using a webhook

Establish a real-time streaming solution to automatically send audit log activities to a designated URL of your choice. Webhook connections allow you to send audit log activities to third-party applications that accept incoming webhooks

Audit log webhooks are customized HTTP callbacks that trigger in response to audit log activities. When an activity occurs, the source system sends an HTTP request to the URL registered for the webhook in JSON format.

It’s important to know that once you setup an integration you will be sending alert data to the third-party tool of your choosing. You should make sure that it’s appropriate for this data to be shared with your third-party tool before setting up the integration.

Who can do this?
Role: Organization admin
Atlassian Cloud: Enterprise plan for Jira or Confluence or Atlassian Guard Premium.
Atlassian Government Cloud: Not available

Register a webhook URL

You can't register more than one Webhook URL for an organization.

To register a webhook URL:

  1. Go to Atlassian Administration. Select your organization if you have more than one.

  2. Select Security > Audit log.

  3. Select Settings.

  4. Select the Webhook tab.

  5. Enter the Webhook URL (the destination where you wish to receive real-time activity updates).

  6. Optionally enter secure authorization credentials to authenticate a user agent with a server, allowing access to a protected resource. Encode the username and password as Authorization: Basic <credentials>.

  7. Select Register webhook

You can't register more than one webhook URL for an organization. You can update or remove the webhook registration if you need to.

Webhook home tab to register webhook

Edit a registered a webhook URL

To edit the details of a registered webhook:

  1. Go to Atlassian Administration. Select your organization if you have more than one.

  2. Select Security > Audit log.

  3. Select Settings.

  4. Select the Webhook tab.

  5. Select Edit details to update the details.

Webhook registeration screen in Audit log

Alternatively, select Remove registration to remove a webhook.

Test a registered a webhook

This test evaluates your webhook's capacity to manage aggregated activities, which are sent with a brief delay to prevent the transmission of redundant updates.

  1. Go to Atlassian Administration. Select your organization if you have more than one.

  2. Select Security > Audit log.

  3. Select Settings.

  4. Select Test registration.

Test webhook registeration

Still need help?

The Atlassian Community is here for you.