# Set Up Your First Listing Alert

This tutorial will guide you through the process of creating a simple Listing Alert with Compass Automations.

{% hint style="info" %}
Note: You can use the Listing Alert Automation set up in this walkthrough with one click from the automation marketplace.
{% endhint %}

### Step 1: Create an Automation

Go to [Automations](https://compass.art/automations) and click **Create Automation**. 

<figure><img src="/files/TLygrRKo9rAHQdKbCEBl" alt=""><figcaption></figcaption></figure>

### Step 2: Name Your Automation

Name your automation. For this guide, we'll name it `Doodles Rainbow Head Listing Alert`.

<figure><img src="/files/ZH6V0ClOyf0i0o6RXVXC" alt=""><figcaption></figcaption></figure>

### Step 3: Select the Trigger

Select the **Token Listed** Trigger. This Trigger initiates the automation when a Token is Listed on any marketplace.&#x20;

<figure><img src="/files/cyL33Q2Sx1OX9hPsa9dc" alt=""><figcaption></figcaption></figure>

### Step 4: Add Collection Filter

Click **Add Filter** and select the Collection filter. This filter ensures the Automation only triggers when a Doodle gets listed.&#x20;

<figure><img src="/files/jsyVBpqwtlTGuJnW1vp3" alt=""><figcaption></figcaption></figure>

### Step 5: Select the Collection

Search for the Doodles collection and select it. Now, the Automation will only trigger if a Listing happens for Doodles.&#x20;

<figure><img src="/files/kIjZLCCwkeLltYYwsfa2" alt=""><figcaption></figcaption></figure>

### Step 6: Choose the Token Traits Filter

Choose the Token Traits filter.&#x20;

<figure><img src="/files/NJts4FXPGr3nqKirG9tP" alt=""><figcaption></figcaption></figure>

### Step 7: Specify Trait Type and Value

Pick the collection again, and the Trait type and value you want to trigger for. Now you have the Trigger set. It will only trigger if a Doodle with a Rainbow Head is listed.&#x20;

<figure><img src="/files/u49f3amnm60qBwK0VNCp" alt=""><figcaption></figcaption></figure>

### Step 8: Pick the Notify Channels Action

Select the **Notify Channels** Action. This Action sends a message to a channel of your choice. Most people use Discord and Telegram.&#x20;

<figure><img src="/files/HTIcbi03HME9MOuQv31O" alt=""><figcaption></figcaption></figure>

### Step 9: Create Notification Text

Create the text for the notification. This text will be received as a message on your device. Sample text:
\
\
🏷️ New Listing \
Collection: \
Listing Price: Ξ \
Collection Floor: Ξ<br>

<figure><img src="/files/FVQr2W9mm09Xw5HDJGfK" alt=""><figcaption></figcaption></figure>

### Step 10: Select the Data to Input

Click the `{}` button to select the data to input, also known as variables. This includes the Collection Name, Collection Listed Floor, and “Value” for the Listing Price.&#x20;

<figure><img src="/files/Dff63A7EQPfx7Y8Rr3bF" alt=""><figcaption></figcaption></figure>

### Step 11: Format OpenSea Link

For the OpenSea Link, note that the link format is `https://opensea.io/assets/ethereum/collectionaddress/tokenid`. The collection address and the token id change, but the rest of the link stays the same. Pick the Collection address and the token id and place them in the right place, separated by a `/`.&#x20;

### Step 12: Set Notification Channel

Set the channel where you want to receive your Listing alerts. If you've already added a channel, select it from your list of channels. If not, learn how to add one here.&#x20;

<figure><img src="/files/oaSjdIkmz1FutQG8jgvX" alt=""><figcaption></figcaption></figure>

### Step 13: Create the Automation

Click **Create**.&#x20;

<figure><img src="/files/LuoI5ieCkzEJp1hZSX68" alt=""><figcaption></figcaption></figure>

### Step 14: Enable the Automation

Click **Enable Automation** in the top-right corner.&#x20;

<figure><img src="/files/q7J2jjrreP2N9jqLZSAc" alt=""><figcaption></figcaption></figure>

### Step 15: Automation is Live!

Your automation is now live! You'll receive alerts on your chosen chat app. You can also track any runs of this automation by going to the History. Learn more about the automation run history here.

<figure><img src="/files/82E7ouqZCtR2k7oSdl96" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.compass.art/automations/set-up-your-first-listing-alert.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.