task.created

WEBHOOK

task.created

{
  "event_type": "task.created",
  "id": "task_public_id",
  "book_id": "book_public_id",
  "subscription_id": "subscription_public_id",
  "user_id": "user_public_id",
  "company_id": "company_public_id",
  "task": {
    "id": "task_public_id",
    "book_id": "book_public_id",
    "title": "Send review summary",
    "description": "Email the meeting summary.",
    "deadline_at": "2026-10-20T17:00:00Z",
    "all_day": false,
    "status": "todo",
    "priority": "medium_priority",
    "is_private": false,
    "completed_at": null,
    "created_at": "2026-10-15T12:00:00Z",
    "updated_at": "2026-10-19T16:15:00Z",
    "assigned_to": {
      "id": "user_public_id",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "assigned_team": null,
    "record": {
      "id": "household_public_id",
      "type": "household",
      "name": "Example household"
    },
    "tags": []
  }
}

Sent when an eligible task is created. Initial rich text and tags do not also emit task.updated. The snapshot is prepared asynchronously and may reflect changes made after the triggering event. Use its updated_at to reconcile local state. Scheduled and unapproved tasks do not emit these events. Fetch the current task with GET /v1/tasks/{id}. Verify the raw request body before processing. See the webhook overview for signing, retries, subscription context, and ordering.

Headers

svix-id

string

required

Delivery message ID. Use for idempotency; overlapping subscriptions have distinct IDs.

svix-timestamp

string

required

Unix timestamp used for signature verification.

svix-signature

string

required

Signature(s) to verify with the endpoint signing secret and a Svix verification library.

Body

application/json

JSON payload sent to your configured webhook endpoint.

subscription_id

string

required

Subscription that caused this delivery.

user_id

string

required

Subscribed Slant user.

book_id

string

required

Book containing the record.

company_id

string

required

Company that owns the book.

event_type

string

required

Allowed value: "task.created"

string

required

ID of the affected task.

task

object

required

Show child attributes

Response

200

Return a successful 2xx response promptly after verifying and durably accepting the delivery. Non-success responses can cause retries.

⌘I

{
  "event_type": "task.created",
  "id": "task_public_id",
  "book_id": "book_public_id",
  "subscription_id": "subscription_public_id",
  "user_id": "user_public_id",
  "company_id": "company_public_id",
  "task": {
    "id": "task_public_id",
    "book_id": "book_public_id",
    "title": "Send review summary",
    "description": "Email the meeting summary.",
    "deadline_at": "2026-10-20T17:00:00Z",
    "all_day": false,
    "status": "todo",
    "priority": "medium_priority",
    "is_private": false,
    "completed_at": null,
    "created_at": "2026-10-15T12:00:00Z",
    "updated_at": "2026-10-19T16:15:00Z",
    "assigned_to": {
      "id": "user_public_id",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "assigned_team": null,
    "record": {
      "id": "household_public_id",
      "type": "household",
      "name": "Example household"
    },
    "tags": []
  }
}

Getting started

Endpoints

Webhooks

Headers

Body

Response