> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions completed webhook

> This webhook is triggered when an action run completes. You can provide your webhook URL when creating an actions run via the `/v1/actions` endpoint.

**Webhook Requirements:**
- The URL must be HTTPS in production
- Your endpoint should respond with a 2xx status code to acknowledge receipt
- The webhook will be sent as a POST request with a JSON payload
- If your endpoint fails to respond or returns an error, Enginy will retry the webhook

**When is it sent:**
- After all actions in a group have finished processing (completed, failed, or cancelled)
- This is sent for each entity (contact or company) in the actions run

**Use cases:**
- Trigger follow-up workflows in your system when enrichment completes
- Get notified when verification or scraping actions finish
- Monitor the progress of bulk operations without polling

**Example webhook setup:**
When creating an actions run, include the `webhookUrl` parameter:

```json
{
  "actions": [{ "type": "VERIFY_LEAD_EMAIL" }],
  "contactIds": [123, 456],
  "webhookUrl": "https://your-domain.com/webhooks/enginy"
}
```

Your webhook endpoint will receive a POST request with the payload described below.



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json webhook /your-webhook-url
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths: {}

````