# ClickUp

Turn the briefs in your ClickUp Lists into Mestra campaigns, with a comment on each brief that links back to Mestra.

Connect ClickUp and Mestra turns each brief in the Lists you choose into a campaign. It comments on the brief with a link to the campaign. It never changes the brief itself.

## Who can do what

- **Owners** turn ClickUp on, connect it, choose the workspace, choose which Lists and Folders hold briefs, change the brief settings, and disconnect.
- Everyone else can read the settings. They can't change them.

## Connect

1. An owner opens **Settings** > **Integrations**, turns on **ClickUp** and reads what Mestra stores, reads and sends. Select **Turn on**.
2. Select **Open ClickUp**, then **Connect ClickUp**.
3. Sign in to ClickUp and allow Mestra.
4. If your ClickUp account has more than one workspace, choose one under **Workspace** and select **Use this workspace**.

The **Connection** card then shows the workspace, a **Connected** pill and who connected it. If it shows **Reconnect needed**, an owner selects **Reconnect ClickUp**.

## Choose your Lists and Folders

1. On the ClickUp page, select **Choose Lists and Folders**, or open the **Briefs** tab.
2. Select **Add a List or Folder** and pick one.
3. For each one, set:
   - **Brand**: a fixed brand, or **From a field** to read it from a field on each brief. If you choose a field, pick it under **Brand field**.
   - **Format set**: the sizes the campaign should make.
   - **Briefs come in**: **When asked** or **Automatically**.
4. For **When asked**, a brief is picked up when it reaches the **Status** you choose, or when it gets the tag you type under **Or a tag**. For **Automatically**, every new brief in the List or Folder is picked up.
5. Optionally open **Fields** to tell Mestra which ClickUp field fills which part of the campaign, such as the name, headline, call to action, dates or web address.
6. Select **Save**. "Saved." shows when it's done.

Select the cross beside a List or Folder to stop watching it, then **Save**.

## What happens to a brief

When a brief is picked up, Mestra makes a campaign from it and posts a comment on the brief, such as "Campaign created in Mestra: 12 formats for Brand A." The comment has an **Open in Mestra** link. If any formats need a look, the comment says how many.

If Mestra can't tell which brand a brief is for, it makes nothing and comments to say so. Name a brand Mestra knows, then send the brief again.

## Brief settings

On the ClickUp page, the **Briefs** card has two switches. Owners can change them.

- **Read the brief's description**: Mestra reads the description to fill in the campaign.
- **Comment on the brief**: Mestra posts its comments.

## Disconnect

An owner selects **Disconnect** on the **Connection** card and confirms. Mestra forgets the connection, your Lists and Folders, and its webhooks. Briefs already received and campaigns stay. Nothing in ClickUp changes, except that Mestra's webhooks are removed.
