Register dynamic webhooks

POST

/rest/api/3/webhook

Registers webhooks.

NOTE: for non-public OAuth apps, webhooks are delivered only if there is a match between the app owner and the user who registered a dynamic webhook.

Permissions required: Only Connect and OAuth 2.0 apps can use this operation.

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///rest/api/3/webhook' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://your-app.example.com/webhook-received",
    "webhooks": [
        {
            "events": [
                "jira:issue_created",
                "jira:issue_updated"
            ],
            "fieldIdsFilter": [
                "summary",
                "customfield_10029"
            ],
            "jqlFilter": "project = PROJ"
        },
        {
            "events": [
                "jira:issue_deleted"
            ],
            "jqlFilter": "project IN (PROJ, EXP) AND status = done"
        },
        {
            "events": [
                "issue_property_set"
            ],
            "issuePropertyKeysFilter": [
                "my-issue-property-key"
            ],
            "jqlFilter": "project = PROJ"
        }
    ]
}'

响应示例

200 - 成功示例

{"webhookRegistrationResult":[{"createdWebhookId":1000},{"errors":["The clause watchCount is unsupported"]},{"createdWebhookId":1001}]}

请求参数

Body 参数application/json

示例

返回响应

🟢200Returned if the request is successful.

application/json

Body

🟠400Returned if the request is invalid.

🟠403Returned if the caller isn't an app.

修改于 2023-07-12 08:28:12

Get dynamic webhooks for app

Delete webhooks by ID