Workast

With the Workast modules in Make, 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 Make

To connect Workast with Make 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 Make account, and add a module from the Workast app into a Make 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.

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.

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 Make 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

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.

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.

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.

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.

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 Make should return during one scenario execution cycle.

Type

Select the space type which you want to list:

  • Group

  • Personal

  • Direct

  • Template

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.

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.

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.

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.

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

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

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