Knowledge CenterAPI References

Webhooks

Receive real-time event notifications when records are created, updated, or deleted in your workspace.

Setup

  1. Go to Settings → Webhooks in your Dalil workspace
  2. Enter your endpoint URL (must be HTTPS)
  3. Select the events you want to receive
  4. Save. Dalil will immediately start sending events.

Event Types

EventTrigger
person.createdA new person was created
person.updatedA person field was updated
person.deletedA person was deleted
company.createdA new company was created
company.updatedA company field was updated
company.deletedA company was deleted
opportunity.createdA new opportunity was created
opportunity.updatedAn opportunity field was updated
opportunity.deletedAn opportunity was deleted
note.createdA new note was created
task.createdA new task was created
task.updatedA task was updated (e.g. status change)

Payload Format

Every webhook delivers a POST request to your endpoint with a JSON body:

{
  "event": "person.updated",
  "workspaceId": "workspace-uuid",
  "objectMetadataId": "object-uuid",
  "recordId": "a1b2c3d4-...",
  "record": {
    "id": "a1b2c3d4-...",
    "name": { "firstName": "John", "lastName": "Smith" },
    "jobTitle": "Senior VP Sales",
    "updatedAt": "2026-04-29T10:30:00.000Z"
  },
  "updatedFields": ["jobTitle"],
  "timestamp": "2026-04-29T10:30:00.123Z"
}

Responding to Webhooks

Your endpoint must return a 2xx status code within 10 seconds. Failed deliveries are retried with exponential back-off up to 3 times. Process events asynchronously and return 200 OK immediately.