Active with remarks
This application needs additional settings. Please follow the documentation below to create your connection.

Workast

With the Workast modules in Boost.space Integrator, you can:

  • watch, list, retrieve, create, update and delete the tasks
  • list, retrieve, create, update and archive the spaces

To get started with Workast:

Connect Workast with Boost.space Integrator

To connect Workast with Boost.space Integrator you need to obtain the API token from your Workast account:

  1. Log in to your Workast account.
  2. Click Your Account Name > Preferences > Generate Token.

    msedge_MA2ESmHzmP.gif
  3. Copy the API Token to a safe place.

    msedge_UIhpuvQVIW.png
  4. Log in to your Boost.space Integrator account, and add a module from the Workast app into a Boost.space Integrator scenario.
  5. Click Add next to the Connection field.

    Workast_1.gif
  6. In the Connection name field, enter a name for the connection.
  7. In the API Token field, enter the token copied in step 3 and click Save.

You have successfully established the connection and can now build scenarios.

Task

You can watch, list, retrieve, create, update and delete tasks using the following modules.

Watch New Task

Triggers when a new task is created in a space.


Webhook Name
Enter the name of the webhook.

Connection
Establish a connection to your Workast account.

For setting up webhooks, see Setting Up Workast Webhooks.

List Space Tasks

Gets the task details given task ID.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID whose task you want to list.

Limit
Set the maximum number of tasks Boost.space Integrator will return during one scenario execution cycle.

Status Is
Enter (map) the status of the task you want to list. For example, in progress.

Order
Select the order in which you want to list the tasks:


  • Created At Ascending

  • Created At Descending

  • Completed At Ascending

  • Completed At Descending

Get a Task

Gets the task details given the task ID.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID whose task details you want to retrieve.

Task ID
Select or map the Task ID whose details you want to retrieve.

Create a Task

Creates a new task in space.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID in which you want to create a task.

Text
Enter the task main text such as a subject line or a heading.

Description
Enter the task details.

Assigned To
Select the users to whom the task is assigned.

Assigned To Email
Add the email addresses of the users to whom the task is assigned.

Start Date
Enter the date when the work on the task has started. See the list of supported date and time formats.

Due Date
Enter the date by which the task must be completed. See the list of supported date and time formats.

Frequency
Select the frequency of the task to be performed. For example, Daily.

Interval
Enter the interval at which the task must be performed.

By Week Day
Select or map the days on which the task repeats.

By Set POS
Select or map the task occurrence.

Each given integer specifies an occurrence number, corresponding to the nth occurrence of the rule inside the frequency period.

The value 0 is not valid.

The valid value(s) are -1, 1, 2, 3, and 4.

Update a Task

Updates specific task details.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the space whose task details you want to update.

Task ID
Select or map the Task ID whose details you want to update.

Text
Enter the task main text such as a subject line or a heading.

Description
Enter the task details.

Start Date
Enter the date when the work on the task has started. See the list of supported date and time formats.

Due Date
Enter the date by which the task must be completed. See the list of supported date and time formats.

Use Common List
Select whether you want to add the task to the common list.

Repeat
Add the repeat options if this is a repetitive task.

Frequency
Select or map the frequency of the task. For example, daily.

Interval
Enter the interval at which the task repeats.

By Weekday
Select the days on which the task repeats.

By Set POS
Select or map the task occurrence.

Each given integer specifies an occurrence number,

The value 0 is not valid.

The valid value(s) are -1, 1, 2, 3, and 4.

Delete a Task

Deletes a task from space.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID whose task details you want to delete.

Task ID
Select or map the Task ID you want to delete.

Space

You can list, retrieve, create, update, and archive spaces using the following modules.

List Spaces

Returns a list of spaces.


Connection
Establish a connection to your Workast account.

Only User Lists
Select to filter sublist only where the user is a participant of the List.

Limit
Set the maximum number of spaces Boost.space Integrator should return during one scenario execution cycle.

Type
Select the space type which you want to list:


  • Group

  • Personal

  • Direct

  • Template

Get a Space

Gets space info details.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID whose details you want to retrieve.

Create a Space

Creates a space.


Connection
Establish a connection to your Workast account.

Participants
Select or map the User ID whom you want to add to the space.

Description
Enter (map) the space details.

Type
Select the space type:


  • Template

  • Group

  • Direct

Privacy
Select the space visibility:


  • Team

  • Private

Name
Enter (map) a name for space.

Channel ID
Enter (map) the Channel ID.

Channel Name
Enter (map) the channel name.

Apps
Add the apps for space.

Send Notifications
Select whether you want to send the notifications to users regarding the space.

Update a Space

Changes space details.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID whose details you want to update.

Name
Enter (map) a name for space.

Slug
Enter (map) the list details of the space.

Description
Enter (map) the details of the space.

Channel ID
Enter (map) the Channel ID.

Channel Name
Enter (map) the channel name.

Task Created
Select whether the task is created in the space.

Task Completed
Select whether the space’s tasks are completed.

Archive a Space

Archives a space.


Connection
Establish a connection to your Workast account.

Space ID
Select or map the Space ID you want to archive.

Other

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized API call.


Connection
Establish a connection to your Workast account.

URL
Enter a path relative to https://api.todobot.com/. For example, /me.

[Note] Note
For the list of available endpoints, refer to the Workast 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 – Search Spaces

The following API call returns the spaces from your Workast account:


URL:

/list?


Method:

GET


yOiqGISMax.png

Matches of the search can be found in the module’s Output under Bundle > Body.

In our example, 2 spaces were returned:


msedge_ADPPHQWGtj.png

Setting Up Workast Webhooks

To set up the Workast webhooks:

 

  1. Open the Watch Tasks module, create a connection, click Save, ad copy the URL address to your clipboard, click OK and save the trigger.

    msedge_4lovx17WJd.gif
  2. Log in to your Workast account.
  3. From the left, click Personal Tasks > Settings > Extensions > Webhooks.

    msedge_6AgfwgM0qy.png
  4. Click Add.
  5. Click New Outgoing Webhooks and enter the following details.

    Name
    Enter a name for the webhook.

    Target URL
    Enter the URL address copied in step 1.

    Receive tasks created
    Select the checkbox if you want to receive triggers when new tasks are created.

    Receive tasks completed
    Select the checkbox if you want to receive triggers when tasks are completed.

    Receive tasks updates
    Select the checkbox if you want to receive triggers when tasks are updated.

    msedge_exr2dYUwbD.png
  6. Click Create.

You have successfully added the webhooks.


msedge_QBAjAzElJB.png