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

Automations allow you to set triggers and define actions so the system can execute tasks for your team to help streamline content workflows. You can integrate entities like [AI Actions](https://www.contentful.com/help/ai-automations/ai-actions/) and [Workflows](https://www.contentful.com/help/ai-automations/workflows/) into these automations.

An automation definition includes a series of steps that execute when a trigger occurs. Automation definitions are environment-scoped, meaning each automation is associated with a specific space and environment.

To learn how to use automations in the web app, refer to [Automations](https://www.contentful.com/help/ai-automations/automations/automations-overview/) in our Help Center.

> **Info**
>
> Automations are available on Pro plans and above. Only space admins can create, edit, and delete automation definitions.

An automation definition includes the following components:

* **Name**: A human-readable name for the automation.
* **Description**: Optional descriptive text explaining the automation's purpose.
* **Triggers**: Events (scheduled or event-based) that initiate the automation.
* **Steps**: An array of actions, conditions, and loops defining the automation's behavior.

#### Step Types

| Step Type     | Description                                             |
| ------------- | ------------------------------------------------------- |
| **Action**    | Performs a task (e.g., update entry, invoke AI action). |
| **Condition** | Evaluates criteria and branches execution.              |
| **Loop**      | Repeats nested steps over a list of items.              |

## Automation definitions collection

[Create an automation definition](/references/content-management-api/automation-definitions/create-an-automation-definition)

Use this endpoint to create a new automation definition in the specified environment.

[Get all automation definitions](/references/content-management-api/automation-definitions/get-all-automation-definitions)

Returns all automation definitions that exist in a given environment.

## Automation definition

[Get automation definition](/references/content-management-api/automation-definitions/get-automation-definition)

Use this endpoint to retrieve a specific automation definition by its ID.

[Update an automation definition](/references/content-management-api/automation-definitions/update-an-automation-definition)

Use this endpoint to update an automation definition for a specified environment.

[Delete an automation definition](/references/content-management-api/automation-definitions/delete-an-automation-definition)

Use this endpoint to delete an automation definition for a specified environment.


## API Docs

- Automation Definitions [Get all automation definitions](https://contentful.com/developers/docs/references/content-management-api/automation-definitions/get-all-automation-definitions.md)
- Automation Definitions [Create an automation definition](https://contentful.com/developers/docs/references/content-management-api/automation-definitions/create-an-automation-definition.md)
- Automation Definitions [Get automation definition](https://contentful.com/developers/docs/references/content-management-api/automation-definitions/get-automation-definition.md)
- Automation Definitions [Update an automation definition](https://contentful.com/developers/docs/references/content-management-api/automation-definitions/update-an-automation-definition.md)
- Automation Definitions [Delete an automation definition](https://contentful.com/developers/docs/references/content-management-api/automation-definitions/delete-an-automation-definition.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://contentful.com/developers/docs/openapi.json)
- [OpenAPI YAML](https://contentful.com/developers/docs/openapi.yaml)