Hive integration overview

Overview

Hive is a project management platform for planning projects, tracking tasks, managing resources, and collaborating on work. Persona’s Hive integration connects Workflows to projects in a Hive workspace.

Integration features

The Hive integration supports four Workflow actions:

List projects: Return the projects available to the connected user.
Create project: Create a project in a workspace.
Retrieve project: Return one project by its ID.
Update project: Change an existing project’s details.

Setting up the Hive integration

Prerequisites

To connect Hive, you need:

A Hive account and workspace.
A Hive API key from My profile > API Info.
Permission to manage integrations in the Persona Dashboard.

Adding a Hive credential

In Hive, select your profile picture, then navigate to My profile > API Info and copy your API key.
In the Persona Dashboard, navigate to Integrations > Marketplace and select Hive.
Click Add Credential and enter a nickname for the credential.
Enter the Hive API key, then save the credential.

Using Hive in a Workflow

Create a Workflow or open an existing one.
Add an Action Step, then select Integrations.
Select Hive and choose your saved credential.
Choose an action and map data into its fields.
Save and publish the Workflow.

Hive operations

List projects

Return the projects available to the connected Hive user.

Optional field

Fields: A comma-separated list of fields to return.

Create project

Create a project in a Hive workspace.

Required fields

Workspace: The workspace identifier.
Name: The project name.

Optional fields

Description.
Start date and end date.
Color.
Budget.
Sharing type: everyone, custom, or me.

Retrieve project

Return one Hive project.

Required field

Project ID.

Update project

Update an existing Hive project.