> ## Documentation index
> Fetch the complete documentation index at: https://dronebundle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# scan.created

> Received when someone starts a new drone map.

Event triggered when someone starts a drone map from a job's photos in the dashboard. The map is processed in the background; you get `scan.ready`, `scan.failed` or `scan.cancelled` when it ends.

Fields that are not set yet, such as the map outputs, are left out of `data`.

## Response Body Parameters

All webhook payloads follow a consistent top-level structure with event-specific data nested within the `data` object.

**delivery_id** `string`

Unique identifier for this delivery. Use this to deduplicate events.

**event** `string`

The event type that triggered the webhook (e.g., `scan.created`).

**timestamp** `number`

Unix timestamp (milliseconds) when the event was delivered.

**workspace_id** `string`

The workspace where the event occurred.

**data** `object`

The new map.

**id** `string`

Unique identifier for the map.

**name** `string`

Map name.

**profile** `string`

What the map produces. One of: `map` (measurable 2D map), `map3d` (2D map plus a textured 3D model), `thermal` (thermal map).

**status** `string`

Map status. Usually `preparing` or `queued` at this point.

**project_id** `string`

The project the map belongs to.

**job_id** `string`

The job whose photos the map is made from.

**project_name** `string`

Project name when the map was started.

**job_name** `string`

Job name when the map was started.

**photo_count** `number`

Number of photos sent for processing.

**created** `number`

Unix timestamp (milliseconds) when the map was started.

**updated** `number`

Unix timestamp (milliseconds) when the map was last updated.

**created_by** `object`

The user who started the map.

**type** `string`

Either `user` or `api_key`.

**id** `string`

User ID or API key ID.

### Example response

```json Example Payload
{
  "delivery_id": "019d5a10-3c42-7d81-9b6e-2f4c8a1e7d90",
  "event": "scan.created",
  "timestamp": 1775201234567,
  "workspace_id": "01986573-8d04-72fc-85b3-573c77a18511",
  "data": {
    "id": "019d5a0e-77a1-7c2b-8f30-6d2e9b4c1a55",
    "name": "Building A roof",
    "profile": "map3d",
    "status": "queued",
    "project_id": "01964c6b-7a3e-7f00-8000-abc123def456",
    "job_id": "019d4350-a1b2-7c3d-8e4f-567890abcdef",
    "project_name": "Westfield Bridge Inspection",
    "job_name": "Roof Inspection - Building A",
    "photo_count": 412,
    "created": 1775198400000,
    "updated": 1775198400000,
    "created_by": {
      "type": "user",
      "id": "03144892-6021-705a-08f2-8e147cff3f28"
    }
  }
}
```

Web version: https://dronebundle.com/docs/webhooks/scan-created
