---
title: "Canvas created"
method: POST
path: "canvas_created"
---

# Canvas created

`POST canvas_created` (webhook)

Sent when a new canvas is created. Event type: `v2.canvas.created`.

## Payload

- CanvasCreatedWebhookV2Envelope
  - `app` CanvasCreatedWebhookV2EnvelopeApp, required
    - `id` string, required: Destination app's id
  - `appDefinition` CanvasCreatedWebhookV2EnvelopeAppDefinition, 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` CanvasCreatedWebhookV2, required: Sent when a new canvas is created
    - `canvasId` string, required
    - `deprecated` boolean, required
    - `featureId` 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)