Active with remarks |
---|
This application needs additional settings. Please follow the documentation below to create your own connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More. |
The atSpoke modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More allow you to watch, create, update, list, retrieve, and delete the resources, requests, and usersCan use the system on a limited basis based on the rights assigned by the admin. More in your atSpoke account.
Prerequisites
-
An atSpoke account
In order to use atSpoke with Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More, it is necessary to have an atSpoke account. If you do not have one, you can create an atSpoke account at atspoke.com.
Note | |
---|---|
The moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More dialog fields that are displayed in bold (in the Boost.space Integrator scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. More, not in this documentation article) are mandatory! |
To connect your atSpoke account to Boost.space Integrator you need to obtain the API Key from your atSpoke account and insert it in the Create a connection dialog in the Boost.space Integrator module.
1. Log in to your atSpoke account.
2. Click Your Account > My Profile > API.
3. Go to Boost.space Integrator and open the atSpoke module’s Create a connection dialog.
4. Copy the API Key to your clipboard.
5. Go to Boost.space Integrator and open the atSpoke module’s Create a connection dialog.
6. In the Connection name field, enter a name for the connection.
7. In the API Key field, enter the API key copied in step 4, and click Continue.
The connection has been established.
TriggersEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... when a new resource is created.
Note | |
---|---|
You do not have to add the webhooksA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. in the atSpoke as it is automatically done for you once you add and save an instant triggerEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... module to your scenario. |
WebhookA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. Name |
Enter a name for the webhook. |
Connection |
|
Description |
Enter the details about the trigger. |
Returns a list of resources.
Connection |
|
Search Query |
Enter the keyword or phrase to list the resources based on the specified query. |
AI |
Select whether you want to use AI to list the resources. |
StatusCreate statuses for each module separately to create an ideal environment for efficient and consistent work. More |
Select the status of the resource you want to list:
|
Team |
Select the team whose resources you want to list. |
Author |
Select the authors whose resources you want to list. |
Review By |
Enter the date to list the resources that should be reviewed by the specified date. See the list of supported date and time formats. |
Limit |
Set the maximum number of resources Boost.space Integrator should return during one scenario execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default).. |
Gets a resource.
Connection |
|
Resource ID |
Select the Resource ID whose details you want to retrieve. |
Creates a new atSpoke resource.
Updates a resource.
Connection |
|
Resource ID |
Select the Resource ID whose details you want to update. |
Author |
Select the user who has created the resource. |
Title |
Enter the name of the resource. |
Body |
Enter the details of the resource. |
Team |
Select the team to which this resource belongs to. |
Deletes a resource.
Connection |
|
Resource ID |
Select the Resource ID you want to delete. |
Note | |
---|---|
You do not have to add the webhooks in the atSpoke as it is automatically done for you once you add and save an instant trigger module to your scenario. |
Triggers when a new request is created.
Webhook Name |
Enter a name for the webhook. |
Connection |
|
Description |
Enter the details about the trigger. |
Triggers when a request is updated.
Webhook Name |
Enter a name for the webhook. |
Connection |
|
Description |
Enter the details about the trigger. |
Returns a list of requests.
Connection |
|
Filter |
Select the option to filter the request based on the specified filters:
|
Status |
Select the status of the requests you want to list. |
Team |
Select the team whose requests you want to list. |
List Request IDs |
Add the Request IDs whose details you want to list. |
Search Query |
Enter the keyword or phrase to list the requests based on the specified query. |
AI |
Select whether you want to use AI to list the requests. |
Limit |
Set the maximum number of requests Boost.space Integrator should return during one scenario execution cycle. |
Gets a request.
Connection |
|
Request ID |
Select the Request ID whose details you want to list. |
Creates a new atSpoke request.
Connection |
|
Subject |
Enter the request subject line. |
Requester |
Select the user who is making the request. |
Body |
Enter the details of the request. |
OwnerCan manage members, managers and owners of a specific space. Can view and manage items. Can edit settings of a given space. More |
Select the user to whom you want to assign the request. |
Team |
Select the team to which you want to assign the request. |
Status |
Select the request status:
|
Privacy Level |
Select the request privacy option:
|
Request Type |
Select the request type. |
Updates a request.
Connection |
|
Subject |
Enter the request subject line. |
Requester |
Select the user who is making the request. |
Body |
Enter the details of the request. |
Owner |
Select the user to whom you want to assign the request. |
Team |
Select the team to which you want to assign the request. |
Status |
Select the request status:
|
Privacy Level |
Select the request privacy option:
|
Request Type |
Select the request type. |
Deletes a request.
Connection |
|
Request ID |
Select the Request ID you want to delete. |
Returns a list of users.
Connection |
|
Search Query |
Enter the keyword or phrase to list the users based on the specified query. |
Status |
Select the status to list only the users with the specified status:
|
Team |
Select the team whose users you want to list. |
Limit |
Set the maximum number of users Boost.space Integrator should return during one scenario execution cycle. |
Looks up a user by email address or ID.
Connection |
|
Search By |
Select the option to choose the user whose details you want to retrieve:
|
|
Select the user’s email address whose details you want to retrieve. |
User ID |
Select the User ID whose details you want to retrieve. |
Updates a user.
Connection |
|
User ID |
Select the User ID whose details you want to update. |
Display Name |
Enter the user’s name as it appears in the account. |
Phone Number |
Enter the user’s phone number. |
|
Enter the user’s email address. |
Unique ID |
Enter the user’s unique ID for identification. |
Job Title |
Enter the user’s job position. For example, |
Location |
Enter the user’s work or home address. |
Department |
Enter the department in which the user works. For example, |
ManagerCan manage members and space managers, view and manage items. Can modify space settings. More |
Enter the user’s manager name. |
Start Date |
Enter the user’s job start date. See the list of supported date and time formats. |
Performs an arbitrary authorized API call.
Connection |
|
URL |
Enter a path relative to For the list of available endpoints, refer to the atSpoke 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. |
The following API call returns all the users from your atSpoke account:
URL: /v1/users
Method: GET
Matches of the search can be found in the module’s Output under BundleA bundle is a chunk of data and the basic unit for use with modules. A bundle consists of items, similar to how a bag may contain separate, individual items. More > Body > resultsIn our example, 3 users were returned: