---
title: "Canvas initialized"
method: POST
path: "canvas_initialized"
---

# Canvas initialized

`POST canvas_initialized` (webhook)

Sent when a user initializes a canvas via trigger in the Benchling UI. Event type: `v2.canvas.initialized`.

## Payload

- CanvasInitializeWebhookV2Envelope
  - `app` CanvasInitializeWebhookV2EnvelopeApp, required
    - `id` string, required: Destination app's id
  - `appDefinition` CanvasInitializeWebhookV2EnvelopeAppDefinition, required
    - `id` string, required: App definition id
    - `versionNumber` string, required: App definition version number
  - `baseURL` string, required: Base tenant URL from which the webhook is coming
  - `channel` 'events' | 'app_signals', required: Channel of the webhook
  - `tenantId` string, required: Global tenant id from which the webhook is coming
  - `version` '0', required: Version of the webhook envelope shape. Always 0.
  - `message` CanvasInitializeWebhookV2, required: Sent when a user initializes a canvas via trigger in the Benchling UI
    - `deprecated` boolean, required
    - `featureId` string, required
    - `resourceId` string, required
    - `userId` string, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/benchling/apis/benchling-webhooks-v2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-webhooks-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-webhooks-v2/revisions/4e78eb99a29d?raw)