MoodLens Help Center

Support articles and setup guides

A classic help-center layout with topics on the left and documentation in the center. Search for integrations, assistant tools, webhooks, team discussions, and AI employee workflows.

Help Center / Webhooks & Security
Webhooks & Security
Admins
Outbound events
Admin setup

Configure webhooks

Create outbound webhooks that let MoodLens push signed event payloads to your external service.

MoodLens Support Team
Last verified April 23, 2026

Management rules

Webhooks are admin-only in shared workspaces.

Maximum 20 webhooks per workspace.

The target URL must use HTTPS.

Private, internal, or local addresses such as localhost, 127.0.0.1, 0.0.0.0, .local, and .internal are blocked.

Supported events and delivery headers

Current events include task.created, task.completed, task.updated, task.deleted, task.assigned, task.status_changed, document.created, document.updated, member.joined, and member.left.

MoodLens sends Content-Type: application/json, X-MoodLens-Signature, X-MoodLens-Event, X-MoodLens-Delivery, and User-Agent: MoodLens-Webhooks/1.0.

The signature is an HMAC-SHA256 of the raw request body using the webhook secret.

Secrets, testing, and failure handling

The webhook secret is shown once at creation time and masked later in list views.

The test action sends a ping event.

MoodLens stores last delivery time, status, code, and consecutive failure count.

A webhook auto-disables after 10 consecutive failures, and re-enabling resets the failure counter and disabled reason.