Hive

The Hive modules allow you to watch, create, update, retrieve, list, and delete the projects, actions, and messages in your Hive account.

Getting Started with Hive

Prerequisites

  • A Hive account

In order to use Hive with Integromat, it is necessary to have a Hive account. If you do not have one, you can create a Hive account at app.hive.com/join.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Hive to Integromat

To connect your Hive account to Integromat you need to obtain the API Key and User ID from your Hive account and insert it in the Create a connection dialog in the Integromat module.

1. Log in to your Hive account and open your Dashboard.

2. Click Your Profile Icon > API information.

SSa6Z7FZEr.gif

3. Copy the API Key and User ID details to a safe place.

hive1.png

4. Go to Integromat and open the Hive module's Create a connection dialog.

IVhicFjykJ.gif

5. In the Connection name field, enter a name for the connection.

6. In the API Key and User ID fields, enter the API key and user ID details copied in step 3 and click Continue.

The connection has been established.

Projects

List Projects

Gets all projects for a given workspace.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose projects you want to list.
Limit Set the maximum number of projects Integromat should return during one scenario execution cycle.

Get a Project

Gets a project.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose project details you want to retrieve.
Project ID Select the Project ID whose details you want to retrieve.

Create a Project

Creates a new project.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose project details you want to retrieve.
Name Enter a name for the project.
Description Enter the details of the project.
Start Date Enter the date when the project begins.
End Date Enter the date when the project must complete.
Sharing Type

Select the project sharing type:

  • Custom
  • Everyone
  • Me
Members

Add the User ID of the members with whom you want to share the project details.

Teams

Add the Team ID with whom you want to share the project details.

Project Custom Fields

Add the custom fields for the project.

Unique ID 

Enter the field value. For example, the assignee.

Label

Enter a label for the custom field.

Value

Enter the value for the custom field.

Color (Optional) Enter the hex code of the color you want to give for the project.
Template Select whether you want to give a template for the project.
Copy From

Select the option to copy the template. For example, Product Roadmap.

Copy Action Statuses Select whether to copy the action status of the project.
Copy Assignees Select whether to copy the assignees.
Access Option

Select the project access:

  • Public
  • Private
Phases Add the phases for the project. For example, Project scope.

Update a Project

Updates a project.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose project details you want to update.
Project ID Select the Project ID whose details you want to update.
Name Enter a name for the project.
Description Enter the details of the project.
Start Date Enter the date when the project begins.
End Date Enter the date when the project must complete.
Color (Optional) Enter the hex code of the color you want to give for the project. For example,  for the blue color, the code is #RRGGBB
Access Option Select the project access:
  • Public
  • Private

Delete a Project

Deletes a project.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose project details you want to delete.
Project ID Select the Project ID you want to delete.

Actions

Watch Created Actions

Triggers when an action is created.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose action details you want to watch.
Limit Set the maximum number of new actions Integromat should return during one scenario execution cycle.

Watch Updated Actions

Triggers when an action is updated.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose action details you want to watch.
Limit Set the maximum number of updated actions Integromat should return during one scenario execution cycle.

List Actions

Gets all actions for a given workspace.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose action details you want to watch.
Limit Set the maximum number of actions Integromat should return during one scenario execution cycle.
Project ID Select the Project ID whose actions you want to list.
Sort Order Select the order to list the actions:
  • Ascending Order
  • Descending Order
Object Select the object to list the actions. For example, Deadline.
Field Name Select the option to filter the actions you want to list. For example, status.
Value Select a value for the filter. For example, completed.

Get an Action

Gets an action.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose action details you want to watch.
Action ID Select the Action ID whose details you want to retrieve. For example, First Draft.

Create an Action

Creates a new action.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID in which you want to create the action.
Title Enter a name for the action.
Description Enter the details of the action.
Assignees Add the User IDs of the assignees for the action.
Project ID Enter the Project ID to which the action belongs to.
Deadline Enter the date by when the action must be complete.
Scheduled Date Enter the date when the action is scheduled to perform.
Process ID Select the Process ID (action Template ID) to apply as an action template.
Custom Fields

Label

Enter a label for the action.

Value

Enter the value for the action field.

Update an Action

Updates an action.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID in which you want to create the action.
Action ID Select the Action ID whose details you want to update. 
Title Enter a name for the action.
Status Enter the status of the action.
Update Children Select whether to update the children.
Urgent Select whether this action is urgent.
Privacy Select the action access:
  • Public
  • Private
Checked Select whether this action is checked.
Parent Select the parent action if this action is a subaction.
Description Enter the details of the action.
Assignees Add the assignees to whom you want to assign the action.
Label Name Add the labels for the action.
Deadline Enter the date by when the action must be complete.
Scheduled Date Enter the date when the action is scheduled to perform.
Custom Fields

Add the custom fields for the action:

Label
Enter a label for the custom field.

Value
Enter the value for the custom field.

Shift Subactions Deadline Select whether this action has shift subaction deadline.

Delete an Action

Deletes an action.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID whose action details you want to delete.
Action ID Select the Action ID you want to delete.

Messages

Create a Message

Creates a new message.

Connection Establish a connection to your Hive account.
Workspace ID Select the Workspace ID in which you want to create the message.
Body Enter the message text.
Container ID Select the Container ID (group) in which the message will be created.
Sender First Name Enter the sender's first name.
Sender Picture Enter the URL address to the sender's picture.
Color (Optional) Select the background color of the message.

Other

Make an API Call

Performs an arbitrary authorized API call.

Connection Establish a connection to your Hive account.
URL

Enter a path relative to https://app.hive.com/api/. For example: v1/actions/create

For the list of available endpoints, refer to the developers.hive.com/reference.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

Headers Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String Enter the request query string.
Body Enter the body content for your API call.

Example of Use - List Projects

The following API call returns all the projects from your Hive account:

URL:
v1/projects

Method:
GET

hive3.png

Matches of the search can be found in the module's Output under Bundle > Body > data
In our example, 7 projects were returned:

hive2.png

 

Popular use cases from our blog

slack-automation-illustration

Slack Automation: 20 Free Templates to Get You Inspired

google-sheets-automation-alt

Google Sheets Automation for Ecommerce: 23 Free Templates

tweet-automation-illustration

How to Get Someone's Tweets Before Anyone Else Does

onboarding-automation-with-integromat-alt

How to Automate Employee Onboarding in Minutes with Integromat

shopify-order-to-manufacturer-illustration-alt

How to Auto Send Shopify Orders to Dropshipping Suppliers [Guide]

strava-exercise-to-google-sheets-illustration

Like a Champ: How to Save Strava Activities to Google Sheets

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.