Webhooks are specific events triggered when something happens in Ghost, like publishing a new post or receiving a new member
Settings > Advanced > Integrations > Add custom integration
. The only required fields to setup a new webhook are a trigger event and target URL to notify. This target URL is your application URL, the endpoint where the POST request will be sent. Of course, this URL must be reachable from the Internet.
If the server responds with 2xx HTTP response, the delivery is considered successful. Anything else is considered a failure of some kind, and anything returned in the body of the response will be discarded.
Event | Description |
---|---|
site.changed | Triggered whenever any content changes in your site data or settings |
post.added | Triggered whenever a post is added to Ghost |
post.deleted | Triggered whenever a post is deleted from Ghost |
post.edited | Triggered whenever a post is edited in Ghost |
post.published | Triggered whenever a post is published to Ghost |
post.published.edited | Triggered whenever a published post is edited in Ghost |
post.unpublished | Triggered whenever a post is unpublished from Ghost |
post.scheduled | Triggered whenever a post is scheduled to be published in Ghost |
post.unscheduled | Triggered whenever a post is unscheduled from publishing in Ghost |
post.rescheduled | Triggered whenever a post is rescheduled to publish in Ghost |
page.added | Triggered whenever a page is added to Ghost |
page.deleted | Triggered whenever a page is deleted from Ghost |
page.edited | Triggered whenever a page is edited in Ghost |
page.published | Triggered whenever a page is published to Ghost |
page.published.edited | Triggered whenever a published page is edited in Ghost |
page.unpublished | Triggered whenever a page is unpublished from Ghost |
page.scheduled | Triggered whenever a page is scheduled to be published in Ghost |
page.unscheduled | Triggered whenever a page is unscheduled from publishing in Ghost |
page.rescheduled | Triggered whenever a page is rescheduled to publish in Ghost |
tag.added | Triggered whenever a tag is added to Ghost |
tag.edited | Triggered whenever a tag is edited in Ghost |
tag.deleted | Triggered whenever a tag is deleted from Ghost |
post.tag.attached | Triggered whenever a tag is attached to a post in Ghost |
post.tag.detached | Triggered whenever a tag is detached from a post in Ghost |
page.tag.attached | Triggered whenever a tag is attached to a page in Ghost |
page.tag.detached | Triggered whenever a tag is detached from a page in Ghost |
member.added | Triggered whenever a member is added to Ghost |
member.edited | Triggered whenever a member is edited in Ghost |
member.deleted | Triggered whenever a member is deleted from Ghost |
whsec_
. This secret needs to be given to Ghost on start up. In a new CLI window run the following: