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; } } }

Webhook Secret Not Set via POST in Jira Software (latest Docker image) 10.5.1

Mohamed Diaa Attallah

I'm using Jira Software in Docker (tag latest), and the backend reports this version:

"version": "10.5.1"

I'm trying to create a webhook via this endpoint:

POST /rest/jira-webhook/1.0/webhooks

Following the documentation here:
https://developer.atlassian.com/cloud/jira/platform/webhooks/#registering-a-webhook-using-the-rest-api--for-connect-and-oauth-2-0-apps-

I'm including a secret field in the payload:

{
  "name": "My Webhook",
  "url": "https://example.com/webhook",
  "events": ["jira:issue_created"],
  "secret": "my-secret-value"
}

The webhook is created successfully, but the secret is not saved — it only works when creating the webhook manually via the UI. This behavior works correctly in Jira Cloud, but not in the self-hosted version.

Is there anything I might be missing?

Should I consider using a different Jira version or API version to enable support for webhook secrets via the REST API?
If so, which specific version would support this functionality?

Accepted answers

Marc -Devoteam-

HI @Mohamed Diaa Attallah

Welcome to the community.

See the documentation here: https://developer.atlassian.com/server/jira/platform/webhooks/#operations-with-a-webhook-via-the-jira-rest-api

This is related to the server platform.

All comments

Marc -Devoteam-

HI @Mohamed Diaa Attallah

Welcome to the community.

See the documentation here: https://developer.atlassian.com/server/jira/platform/webhooks/#operations-with-a-webhook-via-the-jira-rest-api

This is related to the server platform.

Mohamed Diaa Attallah

Thanks for the reference!

I followed the API Hook format outlined in the Jira Server documentation for versions 10 and above. While the webhook is created successfully, the secret field doesn't seem to be set correctly. Here’s the payload I used:

{
  "name": "hookNameExample",
  "url": "https://example/hook",
  "events": ["jira:issue_updated"],
  "secret": "-somesecret"
}

The server documentation doesn’t clearly mention how to set a secret, so I used the secret field name as defined in the Cloud API. However, it appears that this works only on Jira Cloud, not on Server.

Marc -Devoteam-

Hi @Mohamed Diaa Attallah

Correct, Cloud API functions don't work in server.

You could contact Atlassian Support and see if this is even possible with a secret option.

Mohamed Diaa Attallah

@Marc -Devoteam- Appreciate your time! I’ll contact them.

Mohamed Diaa Attallah

I resolved the issue by updating the configuration field in the payload as follows:

configuration: {
  SECRET: 'some-secret',
}

Abiodun Oni

Hey @Mohamed Diaa Attallah

could you share the full payload. I'm still not getting the x-hub-signature in my header even after adding the configuration payload. I'm using the v3 rest api

url: 'https://example.com',

webhooks: [

{

events: ['jira:issue_updated'],

jqlFilter: 'issueKey != 0',

configuration: {

secret: 'secret-value',

Welcome!

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

Quick Links

Find more posts tagged with

jira

cloud

jira-service-management-cloud

jira-service-management