• Access Mode
  • Admin Group
  • Admin User
  • Attachments
  • Backup and Restore
  • Child Content
  • Content Blueprint
  • Content Body
  • Content Descendant
  • Content Labels
  • Content Property
  • Content Resource
  • Content Restrictions
  • Content Version
  • Content Watchers
  • Group
  • Long Task
  • Space
  • Space Label
  • Space Property
  • Space Watchers
  • User
  • User Group
  • User Watch
  • Webhooks
  • Other operations
Server
Confluence Data Center / / REST API

Webhooks

Postman Collection
OpenAPI
GET

Find webhooks

Find webhooks. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Query parameters

limit

string

start

string

event

string

statistics

string

Responses

returns a list of webhooks.

application/json

object
GET/rest/api/webhooks
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 { "pageRequest": { "cursor": { "reverse": true, "cursorType": "SPACE" }, "start": 2154, "limit": 2154 }, "nextCursor": { "reverse": true, "cursorType": "SPACE" }, "prevCursor": { "reverse": true, "cursorType": "SPACE" }, "results": [ { "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "password": "<string>", "username": "<string>" } } ], "start": 25, "limit": 25, "next": "http://localhost:8085/rest/api/latest/../paginate?limit=25&start=50", "self": "http://localhost:8085/rest/api/latest/../paginate?limit=25&start=25", "prev": "http://localhost:8085/rest/api/latest/../paginate?limit=25&start=0" }
POST

Create webhook

Create a webhook via the URL. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Request bodyapplication/json

the webhook to be created.

scopeType

string

events

array<string>

active

boolean

sslVerificationRequired

boolean

name

string

configuration

object

url

string

credentials

RestWebhookCredentials

statistics

object

Responses

returns a created webhook.

application/json

Webhook
POST/rest/api/webhooks
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 curl --request POST \ --url 'http://{baseurl}/confluence/rest/api/webhooks' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "password": "<string>", "username": "<string>" }, "statistics": {} }'
201Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 { "createdDate": "<string>", "updatedDate": "<string>", "sslVerificationRequired": true, "events": [ { "id": "<string>", "i18nKey": "<string>" } ], "name": "<string>", "id": 2154, "active": true, "configuration": {}, "scope": { "id": "<string>", "type": "<string>" }, "url": "<string>", "credentials": { "password": "<string>", "username": "<string>" } }
GET

Get webhook

Get a webhook by id. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

webhookId

string

Required

Query parameters

statistics

boolean

Responses

returns a webhook.

application/json

RestWebhook
GET/rest/api/webhooks/{webhookId}
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "password": "<string>", "username": "<string>" } }
PUT

Update webhook

Update an existing webhook. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

webhookId

string

Required

Request bodyapplication/json

the representation of the updated values for the webhook

scopeType

string

events

array<string>

active

boolean

sslVerificationRequired

boolean

name

string

configuration

object

url

string

credentials

RestWebhookCredentials

statistics

object

Responses

returns a webhook.

application/json

RestWebhook
PUT/rest/api/webhooks/{webhookId}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 curl --request PUT \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "password": "<string>", "username": "<string>" }, "statistics": {} }'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "scopeType": "<string>", "events": [ "<string>" ], "active": true, "sslVerificationRequired": true, "name": "<string>", "configuration": {}, "url": "<string>", "credentials": { "password": "<string>", "username": "<string>" } }
DEL

Delete webhook

Delete a webhook via the URL. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

webhookId

string

Required

Responses

returned if deleted successfully.

DEL/rest/api/webhooks/{webhookId}
1 2 curl --request DELETE \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}'
GET

Get latest invocations

Get the latest invocations for a specific webhook. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

webhookId

string

Required

Query parameters

outcomes

string

event

string

outcome

array<string>

Responses

returns a webhook invocation dataset.

application/json

DetailedInvocation
GET/rest/api/webhooks/{webhookId}/latest
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}/latest' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 { "result": { "description": "<string>", "outcome": "ERROR" }, "request": { "body": "<string>", "headers": {}, "method": "GET", "url": "<string>" }, "finish": "<string>", "start": "<string>", "eventScope": { "id": "<string>", "type": "<string>" }, "id": "<string>", "duration": { "seconds": 2154, "zero": true, "nano": 2154, "negative": true, "units": [ { "durationEstimated": true, "duration": { "seconds": 2154, "zero": true, "nano": 2154, "negative": true }, "timeBased": true, "dateBased": true } ] }, "event": { "id": "<string>", "i18nKey": "<string>" } }
GET

Get statistic

Get the statistics for a specific webhook. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

webhookId

string

Required

Query parameters

event

string

Responses

returns a webhook invocation dataset.

application/json

RestInvocationHistory

GET/rest/api/webhooks/{webhookId}/statistics
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}/statistics' \ --header 'Accept: application/json'
GET

Get statistics summary

Get the statistics summary for a specific webhook. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

webhookId

string

Required

Responses

returns a webhook invocation dataset.

application/json

RestInvocationHistory

GET/rest/api/webhooks/{webhookId}/statistics/summary
1 2 3 curl --request GET \ --url 'http://{baseurl}/confluence/rest/api/webhooks/{webhookId}/statistics/summary' \ --header 'Accept: application/json'
POST

Test webhook

Test connectivity to a specific endpoint. The authenticated user must be an administrator to call this resource.

Forge and OAuth2 apps cannot access this REST resource.

Request

Query parameters

url

string

Required

Responses

returns a webhook.

application/json

any

POST/rest/api/webhooks/test
1 2 3 curl --request POST \ --url 'http://{baseurl}/confluence/rest/api/webhooks/test?url={url}' \ --header 'Accept: application/json'

Rate this page: