Skip to content

Commit

Permalink
docs: change placement of the note & turn it into admonition (#1460)
Browse files Browse the repository at this point in the history
turned new paragraph into admonition
changed placement
added details tag with IP list
  • Loading branch information
TC-MO authored Feb 13, 2025
1 parent 8ceb734 commit bab5caf
Showing 1 changed file with 20 additions and 15 deletions.
35 changes: 20 additions & 15 deletions sources/platform/integrations/programming/webhooks/actions.md
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`

0 comments on commit bab5caf

Please sign in to comment.