Webhooks

Message Events

LifeLoop emits a message event whenever a new conversation thread is opened or a message is posted in an existing thread.

Events

Event typeTriggered when
thread.createdA new message thread is opened
message.createdA new message is posted in a thread

What to do after receiving this event

  1. Verify the X-LifeLoop-Signature header.
  2. Read resourceId from the payload — this is the threadId.
  3. Call GET /api/v1/{tenant}/residents/{resourceId}/personal-activities to fetch the full object.
  4. Update your local data store.
  5. Return HTTP 200.

Note: For message.created, resourceId is the threadId.

← Back to Webhooks Overview
Sample payloadmessage.created.json
{
  "eventId": "evt-a1b2c3d4-0000-0000-0000-000000000001",
  "eventType": "message.created",
  "tenant": "sunrise-001",
  "occurredAt": "2026-06-18T10:30:00Z",
  "resourceId": "thr-001"
}
Fetch the full objectbash
curl https://api.lifeloop.com/api/v1/sunrise-001/residents/thr-001/personal-activities \
  -H "Authorization: Bearer YOUR_SERVICE_TOKEN"