apify-webhooks-events

# Apify Webhooks & Events ## Overview Configure webhooks to receive notifications when Actor runs complete, fail, or time out. Apify supports both persistent webhooks (for all runs of an Actor) and ad-hoc webhooks (for a single run). Event-driven architecture is the recommended pattern for production Apify integrations. ## Event Types | Event | Fired When | |-------|-----------| | `ACTOR.RUN.CREATED` | A new Actor run starts | | `ACTOR.RUN.SUCCEEDED` | Run finishes with `SUCCEEDED` status | | `ACTOR.RUN.FAILED` | Run finishes with `FAILED` status | | `ACTOR.RUN.ABORTED` | Run is manually or programmatically aborted | | `ACTOR.RUN.TIMED_OUT` | Run exceeds its timeout | | `ACTOR.RUN.RESURRECTED` | A finished run is resurrected | ## Instructions ### Step 1: Create a Persistent Webhook Persistent webhooks fire for every run of an Actor: ```typescript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const webhook = await client.webhooks().create({ eventTypes: [ 'ACTOR.RUN.SUCCEEDED', 'ACTOR.RUN.FAILED', 'ACTOR.RUN.TIMED_OUT', ], condition: { actorId: 'YOUR_ACTOR_ID', }, requestUrl: 'https://your-app.com/api/webhooks/apify', payloadTemplate: JSON.stringify({ eventType: '{{eventType}}', createdAt: '{{createdAt}}', actorId: '{{actorId}}', actorRunId: '{{actorRunId}}', defaultDatasetId: '{{resource.defaultDatasetId}}', defaultKeyValueStoreId: '{{resource.default...