Skip to content

docs: change placement of the note & turn it into admonition #1460

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 13, 2025
Merged

docs: change placement of the note & turn it into admonition #1460

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 20 additions & 15 deletions sources/platform/integrations/programming/webhooks/actions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,26 @@ slug: /integrations/webhooks/actions
To send notification, you can use the HTTP request action, which sends an HTTP POST request to a specified URL with a JSON payload. The payload is defined using a payload template, which is a JSON-like syntax that allows you to include variables enclosed in double curly braces `{{variable}}`. This enables the
dynamic injection of data into the payload when the webhook is triggered.

:::tip Webhook delivery

Webhooks are sent from servers that use static IP addresses. If your webhook destination is secured by a firewall, you can add the following IP addresses to your allow list to ensure Apify webhooks are delivered successfully.

<details>
<summary>IP list</summary>
- `3.215.64.207`
- `13.216.80.7`
- `13.216.180.86`
- `34.224.107.31`
- `34.236.208.85`
- `44.198.219.104`
- `44.207.71.44`
- `44.207.141.205`
- `52.4.20.206`
- `52.203.255.236`
</details>

:::

### Response management

The response to the POST request must have an HTTP status code in the `2XX` range. If the response has a different status code, it is considered an error, and the request will be retried periodically with an exponential back-off:
Expand Down Expand Up @@ -164,18 +184,3 @@ The description is an optional string that you can add to the webhook. It serves
The `resource` variable represents the triggering system resource. For example, when using the `ACTOR.RUN.SUCCEEDED` event, the resource is the Actor run. The variable will be replaced by the `Object` that you would receive as a response from the relevant API at the moment when the webhook is triggered. For the Actor run resource, it would be the response of the [Get Actor run](/api/v2#/reference/actors/run-object-deprecated/get-run) API endpoint.

In addition to Actor runs, webhooks also support various events related to Actor builds. In such cases, the resource object will look like the response of the [Get Actor build](/api/v2#/reference/actor-builds/build-object/get-build) API endpoint.

## Source IP addresses

Webhooks are dispatched from servers with static IP addresses. If your webhook destination is protected behind a firewall, you can whitelist these IP addresses to allow Apify webhooks to be delivered:

- `3.215.64.207`
- `13.216.80.7`
- `13.216.180.86`
- `34.224.107.31`
- `34.236.208.85`
- `44.198.219.104`
- `44.207.71.44`
- `44.207.141.205`
- `52.4.20.206`
- `52.203.255.236`
Loading