Webhooks

Register a webhook subscription

Registers a delivery target and returns the secret ACA will sign its deliveries with. Keep it — it is not regenerated on read, but it is returned on read.

Posting the same target_url twice updates the existing subscription's events and re-activates it rather than failing, so an integration that re-registers on every start is safe. Twenty subscriptions per organization; target_url must be https and publicly reachable.

post/v1/webhooks

Request

  • Base URL: https://api.automatedclientacquisition.com
  • URL: https://api.automatedclientacquisition.com/v1/webhooks
  • Auth: HTTP bearer

Request body

target_urlstring uri required

Where deliveries are POSTed. Must be https.

eventsWebhookEvent[] required
sourcestring

Free-form label for what registered this, e.g. n8n.

Response

An existing subscription for this URL was updated.

successboolean

Example response

{
  "success": true,
  "data": {
    "id": "5d2c1b90-3a4e-4f21-b8c7-9e0d1a2b3c4d",
    "target_url": "https://n8n.example.com/webhook/aca-events",
    "events": [
      "message_received",
      "lead_replied"
    ],
    "secret": "7f3a1c9e2b8d4056a1c3e5f7092b4d6e8a0c2e4f6183a5c7d9e1f3057b9d1c3e",
    "is_active": true,
    "source": "n8n",
    "max_attempts": 3,
    "created_at": "2026-08-11T12:00:00.000Z",
    "updated_at": "2026-08-11T12:00:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.