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

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Your Inbox: mentions, receipts and what needs you

> The Inbox lists every notification routed to you, newest first: what needs you, mentions and shares, and receipts of what Hive changed on your accounts.

The **Inbox** is everything Hive routes to you, in one place. Open it with **Inbox** in the
sidebar; the number beside it is how many of your notifications are unread. The bell at the bottom
of the sidebar, beside your name, lists your **unread** notifications, and **View all** opens the
Inbox, which keeps everything. A notification in the bell opens the same place its Inbox card does:
choose it to open the chat, workflow, skill, billing page or account it is about, and it is marked
read and leaves the bell. When **Signals** has items waiting on you, the bell shows
its dot and a **Signals has items waiting on you** row, and **Open Signals** opens Signals at
**Needs you**. It shows no number: Signals carries the count. When nothing is unread and nothing
waits in Signals, the bell says **You're all caught up**. Where it leads is named
at the end of the row, such as **Open chat** or **Open billing**. A workflow approval in the bell
has **Review**, which opens the Inbox at **Needs you**, where you approve or reject it. A
notification that leads nowhere is marked read when you choose it.

The Inbox is yours alone. It lists only notifications addressed to you, and Hive checks your
access again every time you open it: a card about a chat, workflow or agent you can no longer open
is left out, and so is a card about a Signals matter you no longer hold.

## What is in it

The Inbox groups your notifications three ways. **All** shows each group with its newest items;
pick a group to page through all of it.

| Group | What lands there |
| - | - |
| **Needs you** | Decisions only you can make that have no other home: a [skill](https://docs.get-hive.ai/skills/skills.md) the Signals officer suggests from how you work, a [workflow Hive suggests](#suggested-workflows), [templates and agents suggested for your workspace](#suggested-for-your-workspace), a [text from a number](https://docs.get-hive.ai/integrations/messaging.md#inbox-cards) or [Telegram chat](https://docs.get-hive.ai/integrations/messaging.md#telegram-bot) you have not linked to a client, or a workflow run paused at an [Approval](https://docs.get-hive.ai/workflows/workflow-steps.md#approval) step that names you, which you approve or reject right on the card. It lists what still waits on you: everything you have not read yet, and every workflow approval (or run paused for more agent steps) that has not been approved, rejected or expired, even once you have read it. The count beside it is how many that is. Once you open or read any other item it moves to **Earlier**, below the list. Signals items and their approvals stay in Signals: when **Needs you** has nothing of its own but Signals has items waiting on you, it shows **Signals has items waiting on you · Open Signals** instead of saying nothing needs you. |
| **Mentions & shares** | Chat comments that mention you, and chats, files, folders, agents and workflows shared with you. A comment notification names who commented and the chat, for example "Mir commented in “Q3 board pack”". You only get one for a chat that is shared with you, so it never names a chat you can't open. **Open chat** or **Open item** takes you to it. |
| **Receipts** | What Hive **changed** on your accounts, and problems that need you: a workflow run that failed, a schedule Hive paused, a connected account that stopped working. Other notices addressed to you, such as a meeting recap, an agent run you asked to be told about, or a change to your seat, are here too. |

> [!NOTE]
>
> Action approvals are not in the Inbox. A card you are asked to approve in Ask stays in its chat,
> and a Signals approval stays on [Signals](https://docs.get-hive.ai/signals/overview.md). Agents and workflows act on their
> own, so you get a receipt instead. The one exception is a workflow's
> [Approval](https://docs.get-hive.ai/workflows/workflow-steps.md#approval) step, which its author adds on purpose to wait for
> a person: it asks you under **Needs you**.

## Suggested workflows

When Signals keeps raising the same kind of card for you, Hive suggests the free
[workflow template](https://docs.get-hive.ai/workflows/templates.md#hubspot-templates-with-one-approval) that does that work on a
schedule. Once you have had 2 cards of one kind in 30 days and approved at least 1 of them, you get
one **Hive suggests a workflow** card under **Needs you**:

| Cards | Suggested template |
| - | - |
| [Not in your CRM](https://docs.get-hive.ai/signals/matters.md#not-in-your-crm) | **Email contacts to CRM** |
| [Deal slipping](https://docs.get-hive.ai/signals/matters.md#deal-slipping) | **Weekly pipeline check** |

**Set up workflow** opens the template's preview on the Workflows page, with what it needs, such as
**Connect HubSpot**. Only your own cards count, and the suggestion is yours alone. You get it once
per template: dismissing it means it never comes back. Hive does not suggest a template you already
have a workflow from, suggests nothing to a viewer, who cannot start workflows, and waits until a
[Suggested for your workspace](#suggested-for-your-workspace) card is 7 days old. To stop these
cards, turn off **Workflow suggestions** in Settings → Account → Notifications.

## Suggested for your workspace

Hive can set up ready-to-use [workflow templates](https://docs.get-hive.ai/workflows/templates.md) and
[agents](https://docs.get-hive.ai/agents/agent-studio.md) in your workspace for the apps you have connected, and then tell you with
one **Suggested for your workspace** card under **Needs you**. The card is from Hive. It says how
many items it suggests and lists each one by name:

* A **Workflow template** opens on the Workflows page's **Templates** tab, where **Use template**
  makes your own copy that runs with your own connected accounts.
* An **Agent** opens its run page. It reads with your own connected accounts when you run it.

**View suggestions** opens the **Templates** tab, or **Agents** when the card lists only agents.
Opening an item does not change or run anything; you decide what to set up.

The card only lists items you can use: templates in your workspace's Templates tab and agents that
are deployed and shared with you. Members with the Viewer role, who cannot use templates or agents,
never get one. You get each set once: reading or marking it read moves it to **Earlier**, and the
same set is never sent again. To stop these cards, turn off **Suggested for your workspace** in
Settings → Account → Notifications; Hive then sends none.

Hive also emails you a copy of the card, once, at the address you sign in with. The email is from
Hive, in your language, and lists the same items by name, each linked to its place in Hive, with
**Open your Inbox** below. The same set is never emailed twice, and with **Suggested for your
workspace** turned off you get neither the card nor the email. Templates and agents Hive set up for
you show **Hive** as their author or owner, never a person's name.

### Hive suggests from your connected apps

In workspaces where Hive has turned it on, Hive also sends this card by itself, worded **Hive
suggests these for your workspace, based on the apps you've connected**. It lists Hive's own
[investor workflow templates](https://docs.get-hive.ai/workflows/templates.md#investor-templates) and
[investor agents](https://docs.get-hive.ai/agents/build-an-agent.md#investor-templates) whose apps you have connected. It is
sent only in a workspace that Hive's setup research of your website found to be an investor, such
as a venture capital or private equity firm or fund. A consultancy, any other kind of business, or
a workspace whose website did not say what it does gets no card:

| Item | Kind | Apps it needs |
| - | - | - |
| **Weekly deal-flow digest** | Workflow template | Gmail, Google Drive |
| **Founder follow-up drafts** | Workflow template | Gmail |
| **Portfolio update tracker** | Workflow template | Gmail |
| **Pitch intake** | Agent | Gmail, Google Drive |
| **IC memo builder** | Agent | Google Drive |

An **Agent** item opens it in Agent Studio's template library; **Configure template** makes your
own agent from it. A **Workflow template** opens on the **Templates** tab as above.

Hive checks when one of your own accounts finishes connecting, and once a day. It never lists an
item you already use or one any earlier suggestion card listed, read, dismissed or not. It sends
none within 7 days of any earlier suggestion card, and no [workflow suggestion](#suggested-workflows)
comes within 7 days of one, so one connection never brings both. Each card comes with one copy by email, as above.
The email says the same: its subject and the preview line your inbox shows under it say Hive
suggests these items based on the apps you've connected, never that they were set up for you.
Hive's team may also send you a card with these items by hand, worded the same way; it counts as an
earlier suggestion card like any other.
Hive sends none to members with the Viewer role, and none outside investor workspaces. Turning off **Suggested for your workspace** in Settings →
Account → Notifications stops these cards and their emails as well.

## Receipts

A receipt is written only when Hive **changes** something on one of your accounts: it sent or
drafted an email, created or updated a record, booked an event, moved, archived or deleted an
item. Reading, searching and runs that only read never create one.

Each receipt shows:

* **What changed and where** — the app, the account it went through, and the exact item: an
  email's subject and recipient, an event's title and time, a record's name.
* **Who did it** — the agent, the workflow, the Signals matter, or **You, in Ask** when you
  approved a card in a chat, with a link to the run, workflow, agent or chat.
* **When** — the time of each change.
* **The result** — **Done**, or **failed** with the reason the app gave.

When one run changes several things, they are one receipt, for example **Weekly chase agent: 4
drafts created in Gmail**. Select **Show 4 changes** to see each item. A change that is retried
shows only its final result.

A receipt for a [Signals](https://docs.get-hive.ai/signals/overview.md) action you approved stays in your Inbox even when Hive
raises that matter again, for example when it becomes overdue or more urgent.

## Earlier

An item you have opened or marked read leaves **Needs you** and moves to **Earlier**, so the list
only holds what is still waiting for you. Select **Show earlier** under **Needs you** to see them.
A suggested skill you opened is still on Skills → **Suggested** until it is approved or rejected.

A workflow approval, or a run paused for more agent steps, is the exception: it stays in **Needs
you**, and in its count, until it is approved, rejected or expires, even after you read it or
select **Mark all read**. Once it is decided or expires, it leaves the Inbox.

## Find what you need

* **Unread only** hides what you have read, in every group. With it on, **Earlier** is hidden too.
* In **Receipts**, narrow by **App**, **Source** (agents, workflows, Signals or Ask), **Outcome**
  (done or failed) and a **From** and **To** date.
* The list loads 25 at a time; select **Load more** for older items.

On a phone, the Inbox is one list: choose **All**, **Needs you**, **Mentions** or **Receipts**
under the search box, which searches the items already loaded. **Unread only** and the receipt
filters are in **Filters**; the phone has no date range. Tap an item to open it. An approval or a
receipt opens a sheet with its details, where you approve or reject, or see each change. **⋯** on
an item offers **Mark as read**, and **Mark all read** is at the top. See
[Lists on a phone](https://docs.get-hive.ai/get-started/navigate-hive.md#lists-on-a-phone).

## Mark items read

Select **Mark read** on an item, or open it, to mark it read. **Mark all read** at the top marks
every one of your unread notifications read, including those not loaded yet. Marking a
notification read changes nothing else: the change it describes, the comment or the share all
stay as they are.

An unread mention also puts a small dot on its chat in the sidebar, and on the chat's project.
Marking the mention read here, or opening the chat, clears the dot, and opening the chat marks
the mention read. See [Feedback, sharing and history](https://docs.get-hive.ai/ask/ask-hive.md#feedback-sharing-and-history).

Which kinds of notification appear in your **bell** is up to you under **Settings → Account →
Notifications**. Muting a kind there, or raising **How much to show**, quietens the bell and
stops those items being pushed to your devices; the Inbox keeps the complete record. A
[suggested skill](https://docs.get-hive.ai/skills/skills.md#how-often-hive-suggests-a-skill) is always quiet: its card waits in
the Inbox under **Needs you**, never in the bell or as a push notification, and turning off **Skill
suggestions** stops the card as well.

In your browser on a computer, or in the Hive app on your phone, you can also get a push
notification for each new item in your Inbox. See
[Push notifications on your phone or computer](https://docs.get-hive.ai/get-started/install-hive.md#push-notifications-on-your-phone-or-computer).

## Tell Hive what is worth notifying you about

You work the signals Hive notifies you about on [Signals](https://docs.get-hive.ai/signals/triage-signals.md), not in the Inbox. When one
was worth getting, select **Useful** on it there, in its **Details** or its review panel: Hive then notifies you
about more like it.
Only feedback you give yourself moves what Hive notifies you about. Marking an item read does not, and neither
do the cards Hive clears itself, such as a workflow approval card once the run has been approved or rejected.
See [How Hive learns what to notify you about](https://docs.get-hive.ai/signals/overview.md#how-hive-learns-what-to-notify-you-about).

> [card] [Navigate Hive](https://docs.get-hive.ai/get-started/navigate-hive.md)
>
> The sidebar, the bell and the menus.

> [card] [Skills](https://docs.get-hive.ai/skills/skills.md)
>
> Review a skill Hive suggests.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.