Workast

The Workast modules allow you to send notifications to your Workast account.

Getting Started with Workast

Prerequisites

A Workast account
Slack App installed

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

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

Connecting Workast to Integromat

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

1. Login to your Workast account.

2. Click Your Account Name > Preferences > Generate Token.

3. Copy the API Token to your clipboard.

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

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

6. In the API Token field, enter the token copied in step 3 and click Continue.

The connection has been established.

Task

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.

Open the Watch New Task module, establish a connection, click Save and copy the URL address to your clipboard.

2. Login to your Workast account, open the space whose tasks you want to watch. Click + icon > Add Webhook.

3. Click Webhook Icon > Create New Webhook > Enter a name for the webhook > Save. Enter the details for the webhook.

List Space Tasks

Gets the task details given task ID.

Connection	Establish a connection to your Workast account.
Space ID	Select the Space ID whose task you want to list.
Limit	Set the maximum number of tasks Integromat should return during one scenario execution cycle.
Status Is	Enter the status of the task you want to list. For example, In progress, completed.
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 the Space ID whose task details you want to retrieve.
Task ID	Select 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 the Space ID in which you want to create a task.
Text	Enter the task main text.
Description	Enter the details of the text.
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 task begins.
Due Date	Enter the date by when the task must be completed.
Frequency	Select the frequency of the task to be performed. For example, `Daily`, `Weekly`, `Fortnight`, `Monthly`.
Interval	Enter the interval at which the task must be performed.
By Week Day	Select the days on which the task must be performed.
By Set POS	Select 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. Valid value(s) are -1, 1, 2, 3, 4.
Use Current List	When selected, a new task will be added to the current sublist, otherwise, it will be added to the default sublist.

Update a Task

Updates specific task details.

Connection	Establish a connection to your Workast account.
Space ID	Select the Space ID whose task details you want to update.
Task ID	Select the Task ID whose details you want to update.
Text	Enter the task main text.
Description	Enter the details of the text.
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 task begins.
Due Date	Enter the date by when the task must be completed.
Use Current List	When selected, a new task will be added to the current sublist, otherwise, it will be added to the default sublist.
Frequency	Select the frequency of the task to be performed. For example, `Daily`, `Weekly`, `Fortnight`, `Monthly`.
Interval	Enter the interval at which the task must be performed.
By Week Day	Select the days on which the task must be performed.
By Set POS	Select 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. Valid value(s) are -1, 1, 2, 3, 4.

Delete a Task

Deletes a task from space.

Connection	Establish a connection to your Workast account.
Space ID	Select the Space ID whose task details you want to delete.
Task ID	Select the Task ID you want to delete.

Space

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 Integromat 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 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 the User ID whom you want to add to space.
Description	Enter the details of the space.
Type	Select the space type: Template Group Direct
Privacy	Select the visibility of the space: Team Private
Name	Enter a name for space.
Channel ID	Enter the Channel ID.
Channel Name	Enter the channel name.
Apps	Add the apps for space.
Send Notifications	Select whether you want to send the notifications.

Update a Space

Changes space details.

Connection	Establish a connection to your Workast account.
Space ID	Select the Space ID whose details you want to update.
Name	Enter a name for space.
Slug	Enter the list details of the space.
Description	Enter the details of the space.
Channel ID	Enter the Channel ID.
Channel Name	Enter the channel name.
Task Created	Select whether the task is created in the space.
Task Completed	Select whether space's tasks are completed.

Archive a Space

Archives a space.

Connection	Establish a connection to your Workast account.
Space ID	Select the Space ID you want to archive.

Other

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` 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.