BugHerd

The BugHerd modules allow you to watch, create, update, list, retrieve, and delete the projects and tasks in your BugHerd account.

Getting Started with BugHerd

Prerequisites

  • A BugHerd account

In order to use BugHerd with Integromat, it is necessary to have an BugHerd account. If you do not have one, you can create a BugHerd account at bugherd.com/users/registrations/new.

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

Connecting BugHerd to Integromat

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

1. Log in to your BugHerd account.

2. From the top menu, click Settings and copy the API Key to your clipboard.

rkMvvEeckn.gif

3. Go to Integromat and open the BugHerd module's Create a connection dialog.

wRgfsVOUrX.gif

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

5. In the API Key field, enter the API key copied in step 2, and click Continue.

The connection has been established.

Project

Create a Project

Creates a new project.

Connection Establish a connection to your BugHerd account.
Project Name Enter a name for the project.
Project URL Enter the website URL address
Is Active Select whether the project is active.
Is Public Select whether the Project is accessible to the public.

Get a Project

Retrieves a project specified by ID.

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

Update a Project

Updates a project specified by ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose details you want to update.
Project Name Enter a name for the project.
Project URL Enter the website URL address
Is Active Select whether the project is active.
Is Public Select whether the Project is accessible to the public.

Delete a Project

Deletes a project specified by ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID you want to delete.

Tasks

Watch New Task Created

Triggers when a new task is created.

You do not have to add the webhooks in the BugHerd as it is automatically done for you once you add and save an instant trigger module to your scenario.
Webhook Name Enter a name for the webhook.
Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose new tasks you want to watch.

Watch a Task Updated

Triggers when a task is updated.

You do not have to add the webhooks in the BugHerd as it is automatically done for you once you add and save an instant trigger module to your scenario.
Webhook Name Enter a name for the webhook.
Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose updated tasks you want to watch.

Watch a Task Deleted

Triggers when a task is deleted.

You do not have to add the webhooks in the BugHerd as it is automatically done for you once you add and save an instant trigger module to your scenario.
Webhook Name Enter a name for the webhook.
Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose deleted tasks you want to watch.

Watch New Comment Added

Triggers when a new comment is added.

You do not have to add the webhooks in the BugHerd as it is automatically done for you once you add and save an instant trigger module to your scenario.
Webhook Name Enter a name for the webhook.
Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose task's comments you want to watch.

Create a Task

Creates a task on a specific project.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose task you want to create.
Description Enter the details of the task.
External ID Enter a unique custom task ID.
Priority Select the priority of the task. For example, High.
Status Select the status of the task. For example, In Progress.
Requester ID Select the Requester ID who has requested this task.
Assigned To Select the User ID to whom you want to assign this task.
Tag Names Add the tags for the task.

Get a Task

Gets a task specified by ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose task details you want to retrieve.
Task ID Select the Task ID whose details you want to retrieve.

Update a Task

Updates a task specified by ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID whose task details you want to update.
Task ID Select the Task ID whose details you want to update.
Description Enter the details of the task.
External ID Enter a unique custom task ID.

Add a Comment to a Task

Adds a comment to a specific task.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID to whose task you want to add the comment.
Task ID Select the Task ID to which you want to add the comment.
Comment's Text Enter the comment's text which you want to add.
User ID Select the User ID who is adding the comment.

Create an Attachment on a Task

Creates an attachment to a specific task.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID to whose task you want to add an attachment.
Task ID Select the Task ID to which you want to add the attachment.
How do you want to create the attachment?

Select the option using which you want to add the attachment to the task:

  • From URL
  • Upload a file
File Name Enter the file name with extension. For example, sample.xml
File URL Enter the URL address to the file.
File Data Enter (map) the file data.

Find a Task by External ID

Finds a task by the external ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID to whose task you want to add an attachment.
External ID Enter a unique External ID of the task you are searching for.

Get an Attachment from a Task

Gets a specific attachment from a task specified by ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID to whose task's attachment whose details you want to retrieve.
Task ID Select the Task ID whose attachment details you want to retrieve.
Attachment ID Select the Attachment ID whose details you want to retrieve.

Delete an Attachment From a Task

Deletes a specific attachment from a task specified by ID.

Connection Establish a connection to your BugHerd account.
Project ID Select the Project ID to whose task's attachments you want to delete.
Task ID Select the Task ID whose attachment you want to delete.
Attachment ID Select the Attachment ID whose details you want to delete.

Other

Make an API Call

Performs an arbitrary authorized API call.

Connection Establish a connection to your BugHerd account.
URL

Enter a path relative to https://www.bugherd.com/rest. For example: /api_v2/organizations.json

For the list of available endpoints, refer to the BugHerd API Documentation.
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 BugHerd account:

URL:
/api_v2/projects.json

Method:
GET

bugherd2.png

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

bugherd1.png

Popular use cases from our blog

facebook-leads-airtable-article-illustration

How to Easily Import Leads from Facebook to Mailchimp and Airtable

Active-campaign-automation-illustration.png

How to Boost ActiveCampaign Automations With Integromat

Instagram-for-business-2-illustration

Instagram for Business Automation: 3 Powerful Templates to Get Started

How-to-automate-reporting-with-nocode-illustration

Automated Reporting: Get Rolling With 4 Easy, Practical Solutions

How-to-manage-Twitter-from-a-Notion-database-part-1-Illustzration

Can You Tweet From Notion? Yes, and Here’s How to Do It [Tutorial]

slack-automation-illustration

Slack Automation: 20 Free Templates to Get You Inspired

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.