Overview
Webhooks resemble a notification mechanism that can be used to build integrations with CKEditor Cloud Services. CKEditor Cloud Services sends an HTTP POST
request to a configured URL when specified events are triggered.
Webhooks can be used for data synchronization between CKEditor Cloud Services and another system or to build a notifications system. For example, thanks to webhooks, the system might notify the users via email about changes made in the document.
# Security
Every webhook request sent from CKEditor Cloud Services to the configured webhook URL has a signature and a timestamp. Thanks to this, every request received by the server can be checked and confirmed that it comes from CKEditor Cloud Services and has not been modified.
More information about the verification process of signing requests can be found in the Request signature guide.
# Webhook format
Each webhook request sent by CKEditor Cloud Services has the following properties:
event
– The name of the event that triggered the webhook.environment_id
– The ID of the environment.sent_at
– The date when the specified webhook was sent.payload
– The payload of the webook. It contains the data about a specific event.
# Example
Below you can find an example of a sample webhook request sent by CKEditor Cloud Services. It is triggered by a comment added to the comment thread thread-1
in the document with an ID of doc-1
by the user with an ID of user-1
.
{
"event": "comment.added",
"environment_id": "environment-1",
"payload": {
"document": {
"id": "doc-1"
},
"comment": {
"id": "comment-1",
"created_at": "2019-05-29T08:17:53.450Z",
"content": "Some comment content.",
"thread_id": "thread-1",
"user": {
"id": "user-1"
}
}
},
"sent_at": "2019-05-29T08:17:53.457Z"
}
# Next steps
- Check the list of events available in CKEditor Cloud Services.
- Learn how to manage existing webhooks and create new ones.