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

# Automagically: Building a Runbook

> Describe an IT task in plain English and Automagically plans, builds, tests, and prepares a runbook for your approval.

> [!NOTE]
>
> Automagically is currently in a **closed beta**.

## Building a Runbook

A runbook is a reusable automation that resolves a specific IT request. You describe the task in plain English, and Automagically plans it, builds it, tests it, and hands it back to you for approval, ready to run against your clients' environments.

## Start a new runbook

You can start building a runbook in two ways:

* **From the Automagically portal:** click **New Runbook**.\


  ![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-60.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=16435b285b8d71b9a73070f3a2469963)

  ![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-61.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=9185471ab29c6d3d01068e8eacb11ad5)
* **From Super Magic chat:** ask Automagically to build a runbook for the task you have in mind.

## Describe the task

Tell Automagically what you want automated, in plain English, the same way you'd explain it to a colleague.

> [!TIP]
>
> Be specific about how forms and outputs should look. For example: "Present the user selection as a drop-down and allow multiple selections."\\
>
> ![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-62.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=553a3646db6c5373e0927410453ab791)

## How Automagically builds your runbook

Building happens in two phases.

1. **Planning:** Automagically drafts a plan and presents it for your approval. This is your chance to shape the runbook, ask it to add or remove steps, change input fields, or adjust anything else before building starts.\


   ![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-63.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=22b10b22c6224867548640f1fbca939d)

   ![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-64.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=031d52cf8e05c4f424d550ff3f4d6bc4)
2. **Building:** once you approve the plan, Automagically builds the runbook, runs quality checks, and automatically fixes any issues it finds.\


   ![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-65.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=fc1e31882fb530260c28b14d2d33b217)

As part of the build, Automagically opens a testing window so you can try the runbook before it goes live.\


![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-66.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=f6b62702dcc6b7248050e18277267720)

## Approve the runbook

Before a runbook can run in a client environment, it must be reviewed and approved in the **Approvals** tab. Approval includes a code review and requires a successful staging test.\
 See [Automagically: Approving Runbooks](https://docs.getthread.com/automagically/automagically-approving-runbooks.md) for details.\


![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-70.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=a71181286b4155f953be484e7dbb67df)

![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-71.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=1d4cb97150f0044318085fe7332a538b)

![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-72.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=a88f7a5d2a174d895ea0215cfb29f2f4)

## Run it

Once approved, the runbook appears under the **Active** tab in Runbooks and is ready to resolve support requests. See [Automagically: Running Runbooks](https://docs.getthread.com/automagically/automagically-running-runbooks.md) for the ways runbooks can be triggered.

![Image](https://mintcdn.com/thread/0Vm5BYi-kODYdGyK/images/image-73.png?fit=max\&auto=format\&n=0Vm5BYi-kODYdGyK\&q=85\&s=88a5e181626031aa9f14ac27bd895bf6)

![Image](https://mintcdn.com/thread/FmajVEZk2Og-ITvV/images/image-74.png?fit=max\&auto=format\&n=FmajVEZk2Og-ITvV\&q=85\&s=1cd6e29ccd1a56bab11ea3b94e542264)


## Related topics

- [Automagically: Running Runbooks](https://docs.getthread.com/automagically/automagically-running-runbooks.md)
- [Automagically: Approving Runbooks](https://docs.getthread.com/automagically/automagically-approving-runbooks.md)
- [Modifying a Runbook](https://docs.getthread.com/automagically/modifying-a-runbook.md)