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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API Automation Steps

> Une Automation step est une étape d'une version d'une automatisation. Une étape `wait` met un membre en attente pendant `config.delay_seconds`.

Une étape `email` ou `message` exécute son `source_code` pour décider s'il faut envoyer et quoi dire. Les étapes forment une chaîne, et chaque étape désigne l'étape qui la précède. Seule la version brouillon peut être modifiée.

Utilisez l'API Automation steps pour lister les étapes d'une version, et pour ajouter, mettre à jour et supprimer des étapes dans le brouillon. Vous pouvez aussi prévisualiser ce qu'une étape `email` ou `message` enverrait à un membre. Une prévisualisation n'envoie rien.

Le code d'une étape lit le compte via l'API. Il dispose de toutes les autorisations `:read` au niveau du compte que possèdent à la fois le rôle admin et Whop AI, à l'exception de `payout:account:read`. Il ne peut donc pas lire les cartes. Définir le `source_code` d'une étape, ou prévisualiser une étape, nécessite chacune de ces autorisations. Ainsi, un identifiant ne peut pas écrire de code qui lit plus que ce qu'il peut lire lui-même.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List Automation Steps](https://docs.whop.com/fr/api-reference/automation-steps/list-automation-steps.md) | GET `/automation_steps` |
| [Retrieve Automation Step](https://docs.whop.com/fr/api-reference/automation-steps/retrieve-automation-step.md) | GET `/automation_steps/{id}` |
| [Create Automation Step](https://docs.whop.com/fr/api-reference/automation-steps/create-automation-step.md) | POST `/automation_steps` |
| [Preview Automation Step](https://docs.whop.com/fr/api-reference/automation-steps/preview-automation-step.md) | POST `/automation_steps/{id}/preview` |
| [Update Automation Step](https://docs.whop.com/fr/api-reference/automation-steps/update-automation-step.md) | PATCH `/automation_steps/{id}` |
| [Delete Automation Step](https://docs.whop.com/fr/api-reference/automation-steps/delete-automation-step.md) | DELETE `/automation_steps/{id}` |

## Attributs

**id** `string` *required*

ID de l'étape d'automatisation, préfixé par `atos_`. Une étape reçoit un nouvel ID dans chaque version. Sa `key` reste la même.

**action\_type** `string` *required*

Ce que fait l'étape : `wait` met le membre en attente pendant `config.delay_seconds`, `email` lui envoie un e-mail, et `message` lui envoie un message de la part d'un membre de l'équipe. Une étape brouillon peut basculer entre `email` et `message`, ce qui efface `config.sender_id`. Une étape `wait` ne peut pas devenir une étape d'envoi, ni l'inverse.

Options disponibles : `wait`, `email`, `message`

**automation\_id** `string` *required*

ID de l'automatisation à laquelle appartient l'étape, préfixé par `ato_`.

**config** `object` *required*

Les paramètres de l'étape pour son `action_type` : `delay_seconds` pour un `wait`, `sender_id` pour un `email` ou un `message`. L'écrire remplace l'objet entier.

**created\_at** `string` *required*

Date de création de l'étape, sous forme d'horodatage ISO 8601.

**issues** `string[]` *required*

Ce qui doit être corrigé avant que le brouillon puisse être publié, comme du code qui n'a pas encore été écrit. Vide lorsqu'il n'y a rien.

**key** `integer` *required*

Identifie la même étape d'une version à l'autre. Une nouvelle étape reçoit une clé qu'aucune étape de l'automatisation n'a utilisée.

**previous\_step\_id** `string | null` *required*

ID de l'étape après laquelle celle-ci s'exécute, préfixé par `atos_`. `null` lorsqu'elle s'exécute en premier, directement après l'inscription du membre.

**sender** `email_address or user | null` *required*

L'expéditeur désigné par `config.sender_id`. `null` sur un `wait`, et lorsque l'étape envoie depuis l'expéditeur par défaut.

**source\_code** `string | null` *required*

Le code d'une étape `email` ou `message` : un module TSX dont l'export par défaut reçoit le membre et renvoie `message.send()`, `message.skip()` ou `message.exit()` depuis `whop:message`. Une étape `email` envoie son `subject`, son élément `react` comme corps et son `text` comme partie en texte brut. Une étape `message` envoie son `text`. Le code peut importer `react` et `@react-email/components`. Il lit le compte via le client `whop` de `whop:message`, qui ne peut que lire. Ce client dispose de toutes les autorisations `:read` au niveau du compte que possèdent à la fois le rôle admin et Whop AI, à l'exception de `payout:account:read`, comme indiqué pour la prévisualisation d'une étape. Le définir, ou prévisualiser l'étape, nécessite chacune de ces autorisations. Jusqu'à 64 000 caractères. `null` sur un `wait`, et tant qu'il n'est pas écrit.

**updated\_at** `string` *required*

Date de dernière mise à jour de l'étape, sous forme d'horodatage ISO 8601.

**version** `integer` *required*

La version de l'automatisation dont fait partie cette étape. Seules les étapes de la version brouillon peuvent être modifiées.

**waiting\_enrollments\_count** `integer` *required*

Membres de la version de cette étape qui attendent son exécution.

```json AutomationStep theme={null}
{
	"id": "atos_xxxxxxxxxxxxxx",
	"automation_id": "ato_xxxxxxxxxxxxxx",
	"version": 3,
	"key": 2,
	"previous_step_id": "atos_yyyyyyyyyyyyyy",
	"action_type": "email",
	"config": {
		"sender_id": "emaddr_xxxxxxxxxxxxxx"
	},
	"sender": {
		"id": "emaddr_xxxxxxxxxxxxxx",
		"object": "email_address",
		"address": "support@shinetime.example"
	},
	"source_code": "export default () => message.send({ subject: \"Thanks for booking!\", text: \"See you on Saturday.\" });",
	"issues": [],
	"waiting_enrollments_count": 5,
	"created_at": "2026-10-01T15:30:00.000Z",
	"updated_at": "2026-10-02T08:45:00.000Z"
}
```


## Related topics

- [API Automations](https://docs.whop.com/fr/api-reference/automations/automation.md)
- [List Automation Steps](https://docs.whop.com/fr/api-reference/automation-steps/list-automation-steps.md)
- [Delete Automation Step](https://docs.whop.com/fr/api-reference/automation-steps/delete-automation-step.md)
