> ## 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 de Automation Steps

> Un Automation step es un paso de una versión de una automatización. Un paso `wait` retiene a un miembro durante `config.delay_seconds`.

Un paso `email` o `message` ejecuta su `source_code` para decidir si envía algo y qué dice. Los pasos forman una cadena, y cada paso indica el paso anterior. Solo la versión en borrador puede cambiar.

Usa la API de Automation steps para listar los pasos de una versión, y para añadir, actualizar y eliminar pasos en el borrador. También puedes previsualizar lo que un paso `email` o `message` enviaría a un miembro. Una vista previa no envía nada.

El código de un paso lee la cuenta a través de la API. Tiene todos los permisos `:read` a nivel de cuenta que tienen tanto el rol de administrador como Whop AI, excepto `payout:account:read`. Por lo tanto, no puede leer tarjetas. Establecer el `source_code` de un paso, o previsualizar un paso, requiere todos esos permisos. Así, una credencial no puede escribir código que lea más de lo que ella misma puede leer.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Automation Steps](https://docs.whop.com/es/api-reference/automation-steps/list-automation-steps.md) | GET `/automation_steps` |
| [Obtener Automation Step](https://docs.whop.com/es/api-reference/automation-steps/retrieve-automation-step.md) | GET `/automation_steps/{id}` |
| [Crear Automation Step](https://docs.whop.com/es/api-reference/automation-steps/create-automation-step.md) | POST `/automation_steps` |
| [Previsualizar Automation Step](https://docs.whop.com/es/api-reference/automation-steps/preview-automation-step.md) | POST `/automation_steps/{id}/preview` |
| [Actualizar Automation Step](https://docs.whop.com/es/api-reference/automation-steps/update-automation-step.md) | PATCH `/automation_steps/{id}` |
| [Eliminar Automation Step](https://docs.whop.com/es/api-reference/automation-steps/delete-automation-step.md) | DELETE `/automation_steps/{id}` |

## Atributos

**id** `string` *required*

ID del paso de la automatización, con el prefijo `atos_`. Un paso obtiene un ID nuevo en cada versión. Su `key` se mantiene igual.

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

Lo que hace el paso: `wait` retiene al miembro durante `config.delay_seconds`, `email` le envía un correo electrónico y `message` le envía un mensaje de un miembro del equipo. Un paso en borrador puede cambiar entre `email` y `message`, lo que borra `config.sender_id`. Un `wait` no puede convertirse en un paso de envío, ni al revés.

Opciones disponibles: `wait`, `email`, `message`

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

ID de la automatización a la que pertenece el paso, con el prefijo `ato_`.

**config** `object` *required*

La configuración del paso para su `action_type`: `delay_seconds` para un `wait`, `sender_id` para un `email` o `message`. Escribirlo reemplaza el objeto completo.

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

Cuándo se creó el paso, como marca de tiempo ISO 8601.

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

Lo que debe corregirse antes de poder publicar el borrador, como código que aún no se ha escrito. Vacío cuando no hay nada.

**key** `integer` *required*

Identifica el mismo paso entre versiones. Un paso nuevo obtiene una key que ningún paso de la automatización ha usado.

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

ID del paso tras el cual se ejecuta este, con el prefijo `atos_`. `null` cuando se ejecuta primero, justo después de que el miembro se inscribe.

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

El remitente que indica `config.sender_id`. `null` en un `wait`, y cuando el paso envía desde el remitente predeterminado.

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

El código de un paso `email` o `message`: un módulo TSX cuya exportación predeterminada recibe al miembro y devuelve `message.send()`, `message.skip()` o `message.exit()` de `whop:message`. Un paso `email` envía su `subject`, su elemento `react` como cuerpo y su `text` como parte de texto plano. Un paso `message` envía su `text`. El código puede importar `react` y `@react-email/components`. Lee la cuenta a través del cliente `whop` de `whop:message`, que solo puede leer. Ese cliente tiene todos los permisos `:read` a nivel de cuenta que tienen tanto el rol de administrador como Whop AI, excepto `payout:account:read`, según se indica para previsualizar un paso. Establecerlo, o previsualizar el paso, requiere todos esos permisos. Hasta 64.000 caracteres. `null` en un `wait`, y hasta que se escribe.

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

Cuándo se actualizó el paso por última vez, como marca de tiempo ISO 8601.

**version** `integer` *required*

La versión de la automatización de la que forma parte este paso. Solo pueden cambiar los pasos de la versión en borrador.

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

Miembros en la versión de este paso que están esperando a que se ejecute.

```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 de Automations](https://docs.whop.com/es/api-reference/automations/automation.md)
- [API de Automation Enrollments](https://docs.whop.com/es/api-reference/automation-enrollments/automation-enrollment.md)
- [List Automation Steps](https://docs.whop.com/es/api-reference/automation-steps/list-automation-steps.md)
