# Webhooks

{% hint style="warning" %}
Webhooks require access to the [Setka Cloud API](/help-center/api/getting-posts-from-the-personal-account-with-setka-cloud-api.md). Contact our [customer support](https://editor.setka.io/support) to gain access.
{% endhint %}

To connect your account with a webhook:

1. Go to **Integrations > Integrate Setka Posts > Other CMS**.
2. Click **Add Webhook** in the **Webhook endpoints** section.
3. Specify your webhook endpoint URL in the corresponding field.
4. Select the [notification type](/help-center/api/setka-webhooks.md#available-notification-types) below the endpoint URL and hit the **Save settings** button.

![](/files/-MYuZwyhKfGgCjBAdOO3)

## Available notification types

* **Create post** — notifies the endpoint if some new post is published on your account.
* **Update post** — notifies the endpoint if some of the earlier published posts were updated.

## Available data

The data sent via webhooks is similar to the one you can get via Content Cloud API. Thus you can get:

* The post's title and HTML code.
* The links to related CSS, JS, and media files.
* Auxiliary data, such as author name, publication date, and reading time.

{% hint style="info" %}
Check the [Content Cloud API documentation](/help-center/api/getting-posts-from-the-personal-account-with-setka-cloud-api.md#h_01EQDC5WKH1VTM6X69TRSDTAMJ) for more info about the data received.
{% endhint %}

## Publishing and updating posts

There are several ways of updating and publishing posts.

### Publishing

To publish the post, click the **Publish** button either on the post's badge in the Posts section of the [Setka account](https://editor.setka.io/app)

![Screenshot of the Setka Editor interface: publishing the post](/files/-MYuXGisA9QB3w6pEFp-)

or in the editor itself:

![Screenshot of the Setka Editor interface: publishing the post](/files/-MYuXS5WMCw1hViXZ1c2)

This will notify the [**Create post**](/help-center/api/setka-webhooks.md#available-notification-types) webhook endpoint about the new post on the Setka account. The message will include all the [post data](/help-center/api/setka-webhooks.md#available-data).

### Updating

Before updating the post, [publish it](/help-center/api/setka-webhooks.md#publishing), make some changes and save them by clicking the **Save draft** button.

Then, to update the post, click the **Republish** button on the post editor page:

![Screenshot of the Setka Editor interface: updating the post](/files/-M_aKR-Wf4yYXv2Dkho-)

This will notify the [**Update post**](/help-center/api/setka-webhooks.md#available-notification-types) webhook endpoint about the changes in the specific post on the Setka account. The message will include all the [post data](/help-center/api/setka-webhooks.md#available-data).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://setka.gitbook.io/help-center/api/setka-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
