> 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.

# Run created

POST 

Sent to Benchling Apps subscribed to `v3.run.created` when a Run they can access is created.

Reference: https://docs.benchling.com/docs/api/benchling-api/run/created

## Request

### Payload

- `app` (WebhookApp, required) — The Benchling App the webhook was delivered to.
- `appDefinition` (WebhookAppDefinition, required) — The app definition the receiving app was installed from.
- `baseURL` (string, required) — Base URL of the tenant the webhook was sent from.
- `message` (RunCreatedWebhookV3, required) — Message body of a `v3.run.created` event.
- `tenantId` (string, required) — Global ID of the tenant the webhook was sent from.
- `version` (enum, required) — Version of the webhook envelope shape. Always `0`.
  - Allowed values: `0`

## Types

### WebhookApp

The Benchling App the webhook was delivered to.

- `id` (string, required) — API ID of the app.

### WebhookAppDefinition

The app definition the receiving app was installed from.

- `id` (string, required, nullable) — API ID of the app definition.
- `versionNumber` (string, required) — Version of the app definition the receiving app is installed at.

### RunCreatedWebhookV3

Message body of a `v3.run.created` event.

- `type` (enum, required) — The event type.
  - Allowed values: `v3.run.created`
- `createdAt` (datetime, required) — RFC 3339 timestamp of when the event was created.
- `deprecated` (boolean, required) — Whether this event type is deprecated.
- `id` (string, required) — API ID of the event.
- `resourceId` (string, required) — API ID of the resource the event is about.
- `stability` (enum, required) — Stability of the resource type the event is about.
  - Allowed values: `stable`, `beta`