List Missive Shared Labels

The List Missive Shared Labels action returns shared labels from Missive. Use hierarchy, name, and sort options to produce a predictable list for later workflow steps.

When to Use This Action

Use this action when:

• You need the shared labels available to a Missive connection
• You want the direct children or all descendants of a label
• You need to find labels by name before another action uses their IDs
• You want a compact list that you can iterate over in a later step

Don't use this action when you need to add or change a label. Use Create Missive Shared Label or Update Missive Shared Label instead.

How It Works

The action follows this order:

1. Loads all accessible shared labels from Missive.
2. Selects labels from the requested part of the hierarchy.
3. Applies the optional name search to that selection.
4. Sorts the remaining labels.
5. Returns a compact array of label objects.

The workflow history details show the labels returned on each Missive page and the final labels selected after hierarchy, name, and sort options are applied.

Choose a Hierarchy Level

Missive shared labels can form a hierarchy. A root label has no parent. A nested label has another shared label as its parent.

The Parent Label and Include Nested Descendants fields control the scope:

Parent Label	Include Nested Descendants	Result
Empty	Off	Root labels only
Empty	On	All accessible labels at every level
Selected	Off	Direct children of the selected label only
Selected	On	All descendants beneath the selected label at every depth

The action never includes the selected parent in its own results. If you enter a parent ID that does not exist in the accessible label set, the action follows your Error Handling choice instead of returning an empty list.

Search by Name

The action applies Label Name Search after it selects the hierarchy scope.

• With Exact Name Match off, the action uses a case-insensitive substring match.
• With Exact Name Match on, the complete label name must match, ignoring letter case.
• With no search term, the action keeps every label in the selected hierarchy scope.

For example, a search for support can match both Support and Priority Support when exact matching is off.

Sort the Results

Choose one of these ascending sort orders:

Sort By	Behavior
Name	Sorts names without regard to letter case. The full path and then the label ID resolve ties predictably.
ID	Sorts label IDs in lexicographic order.

Configuration

Label Selection

Field	Description
Missive Connection	Select a Missive connection. Leave this empty to use your default Missive connection.
Parent Label	Select a parent label, or unlock the field to enter a label ID or text expression. Clear the field to select the root.
Include Nested Descendants	Include every descendant beneath the selected parent. With a blank parent, this includes every accessible label. Default: off.
Label Name Search	Optionally filter the selected labels by name. This field supports text expressions.
Exact Name Match	Require the complete label name to match the search term. Default: off.
Sort By	Sort by Name or ID. Default: Name.
Error Handling	Choose what the workflow does if validation or a Missive request fails.

The locked Parent Label field lists accessible labels and displays their hierarchy paths. Unlock it when you need to supply an ID or text expression from an earlier workflow step.

Returned Variables

The action returns an array directly. It does not place the array inside a Missive response wrapper. Each item contains only these compact label properties:

Property	Type	Description
id	string	The Missive shared-label ID.
name	string	The label name without parent names.
parent_id	string or null	The direct parent label ID, or null for a root label.
path	string	The full label path, including parent names.
organization_id	string	The Missive organization ID that owns the label.

FAQs

What does a blank Parent Label mean?

A blank parent selects the root of the hierarchy. With Include Nested Descendants off, the action returns only root labels. With it on, the action returns all accessible labels.

Does recursive mode include the selected parent?

No. Recursive mode starts beneath the selected parent and returns its descendants.

Why can two labels have the same name in the results?

Missive can contain labels with the same name in different hierarchy locations or organizations. Use path, parent_id, and organization_id to distinguish them.