> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

# Workflow task created

POST 

Sent to Benchling Apps subscribed to `v2.workflowTask.created`.

Reference: https://docs.benchling.com/docs/api/v2-webhooks/workflow-task/created

## Request

### Payload

- `app` (WorkflowTaskCreatedWebhookV2EnvelopeApp, required)
- `appDefinition` (WorkflowTaskCreatedWebhookV2EnvelopeAppDefinition, required)
- `baseURL` (string, required) — Base tenant URL from which the webhook is coming
- `channel` (enum, required) — Channel of the webhook
  - Allowed values: `events`, `app_signals`
- `tenantId` (string, required) — Global tenant id from which the webhook is coming
- `version` (enum, required) — Version of the webhook envelope shape. Always 0.
  - Allowed values: `0`
- `message` (WorkflowTaskCreatedWebhookV2, required)

## Types

### WorkflowTaskCreatedWebhookV2EnvelopeApp

- `id` (string, required) — Destination app's id

### WorkflowTaskCreatedWebhookV2EnvelopeAppDefinition

- `id` (string, required) — App definition id
- `versionNumber` (string, required) — App definition version number

### WorkflowTaskCreatedWebhookV2

- `createdAt` (datetime, required) — ISO 8601 date-time string. The time at which the event was created.
- `deprecated` (boolean, required)
- `id` (string, required) — Unique identifier for the event
- `resourceId` (string, required) — Unique identifier for the resource that the event is associated with
- `schema` (EventResourceSchema, required, nullable) — The schema of the associated resource
- `type` (enum, required)
  - Allowed values: `v2.workflowTask.created`

### EventResourceSchema

The schema of the associated resource

- `id` (string, required) — Unique identifier for the schema