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

# Create a Prompt in the UI

> This guide will show you how you can use Humanloop to quickly create a new prompt and experiment with it.

In this quickstart you'll create a prompt in the UI, experiment with it and then see logs from your experimentation.

#### Account setup

#### Create a Humanloop Account

If you haven’t already, create an account or log in to Humanloop

#### Add an OpenAI API Key

If you’re the first person in your organization, you’ll need to add an API key to a model provider.

1. Go to OpenAI and [grab an API key](https://platform.openai.com/api-keys)
2. In Humanloop [Organization Settings](https://app.humanloop.com/account/api-keys) set up OpenAI as a model provider.

> **Info**
>
> Using the Prompt Editor will use your OpenAI credits in the same way that the
> OpenAI playground does. Keep your API keys for Humanloop and the model
> providers private.

## Get Started

### Create a Prompt File

When you first open Humanloop you’ll see your File navigation on the left. Click ‘**+ New**’ and create a **Prompt**.

![](/docs/_fern-img/839c05752b46bcbe68b6a4d4871b0ad54aa401b557ec69baf800c66dd6605289.webp)

In the sidebar, rename this file to "Comedian Bot" now or later.

### Create the Prompt template in the Editor

The left hand side of the screen defines your Prompt – the parameters such as model, temperature and template. The right hand side is a single chat session with this Prompt.

![](/docs/_fern-img/bd73541ed1ed343f1aa4d43d423a73cde3169db401631ffbe309e10079fd36d6.webp)

In the editor, update the system message to:

```
You are a funny comedian. Write a joke about {{topic}}.
```

![](/docs/_fern-img/6c8bf026adf4480dbfad2fe692b6a933e0de461effd0cdd94cf1c47c530370df.webp)

This message forms the chat template. It has an input slot called `topic` (surrounded by two curly brackets) for an input value that is provided each time you call this Prompt.

On the right hand side of the page, you’ll now see a box in the **Inputs** section for `topic`.

1. Add a value for `topic` e.g. music, jogging, whatever
2. Click **Run** in the bottom right of the page

This will call OpenAI’s model and return the assistant response. Feel free to try other values, the model is *very* funny.

You now have a first version of your prompt that you can use.

### Save your first version of this Prompt

1. Click the **Save** button at the top of the editor
2. Enter **Initial Comedian Setup** in the version name field
3. Enter **Prompt for making (not so) funny jokes!** in the description field
4. Click **Save**

![](/docs/_fern-img/3ee06b7926a5ce932cd2b90e4b00f8d450cce378137f10278df5c02ae227d9a2.webp)

### View the logs

Under the Prompt File, click ‘Logs’ to view all the generations from this Prompt

Click on a row to see the details of what version of the Prompt generated it. From here you can give feedback to that generation, see performance metrics, open up this example in the Editor, or add this log to a Dataset.

![](/docs/_fern-img/3154bf4ca107872314e9353d516687b4d692370a60087d5bb33f9df4ec6693d7.webp)

## Next Steps

Well done! You've now created your first Prompt.