---
title: "AutomationClient.create_storage_event_automation"
description: "Create an automation that submits a task when objects are added to storage."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

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

# AutomationClient.create_storage_event_automation

import { Fragment } from "astro/jsx-runtime";

import ApiReference from "@docs/components/ApiReference.astro";

import ParamField from "@docs/components/ParamField.astro";

```python
def AutomationClient.create_storage_event_automation(
    name: str,
    task: StorageEventTask,
    triggers: list[tuple[StorageLocation, str]] | tuple[StorageLocation, str],
    cluster: ClusterSlugLike | None = None,
    max_retries: int = 0,
) -> AutomationPrototype
```

Create an automation that submits a task when objects are added to storage.

## Parameters

**name**

type: str

required: true

Name of the automation to create.

**task**

type: StorageEventTask

required: true

Task to run when a matching storage event occurs.

**triggers**

type: list[tuple[StorageLocation, str]] | tuple[StorageLocation, str]

required: true

One trigger or a list of triggers. Each trigger contains a storage location and a glob pattern.

**cluster**

type: ClusterSlugLike | None

Cluster to run the task on. If not provided, the default cluster is used.

**max_retries**

type: int

Maximum number of retries for the task. Defaults to `0`.

## Returns

The created automation prototype.

<h2 id="request-example">Usage example</h2>

```python
location = (
    client.automations().storage_locations()[0]
)

automation = client.automations().create_storage_event_automation(
    name="ingest-new-scenes",
    task=IngestScene(),
    triggers=(location, "incoming/**/*.json"),
)
```

Source: https://tilebox.com/docs/api-reference/python/tilebox.workflows/AutomationClient.create_storage_event_automation/index.mdx