atSpoke

The atSpoke modules allow you to watch, create, update, list, retrieve, and delete the resources, requests, and users in your atSpoke account.

Getting Started with atSpoke

Prerequisites

  • An atSpoke account

In order to use atSpoke with Integromat, it is necessary to have an atSpoke account. If you do not have one, you can create an atSpoke account at atspoke.com.

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

Connecting atSpoke to Integromat

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

1. Log in to your atSpoke account.

2. Click Your Account > My Profile > API.

TJ06OZnaqF.gif

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

BXEHvBwfkU.gif

4. Copy the API Key to your clipboard.

atspoke1.png

5. Go to Integromat and open the atSpoke module's Create a connection dialog.

UutWSgkCCP.gif

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.

Resources

Watch New Resources

Triggers when a new resource is created.

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.
Webhook NameEnter a name for the webhook.
ConnectionEstablish a connection to your atSpoke account.
DescriptionEnter the details about the trigger.

List Resources

Returns a list of resources.

ConnectionEstablish a connection to your atSpoke account.
Search QueryEnter the keyword or phrase to list the resources based on the specified query.
AISelect whether you want to use AI to list the resources.
StatusSelect the status of the resource you want to list:
  • OK
  • Needs Review
  • Deprecated
TeamSelect the team whose resources you want to list.
AuthorSelect the authors whose resources you want to list.
Review ByEnter the date to list the resources that should be reviewed by the specified date. See the list of supported date and time formats.
LimitSet the maximum number of resources Integromat should return during one scenario execution cycle.

Get a Resource

Gets a resource.

ConnectionEstablish a connection to your atSpoke account.
Resource IDSelect the Resource ID whose details you want to retrieve.

Create a Resource

Creates a new atSpoke resource.

ConnectionEstablish a connection to your atSpoke account.
TitleEnter the name of the resource.
AuthorSelect the user who has created the resource.
BodyEnter the details of the resource.
TeamSelect the team to which this resource belongs to.

Update a Resource

Updates a resource.

ConnectionEstablish a connection to your atSpoke account.
Resource IDSelect the Resource ID whose details you want to update.
AuthorSelect the user who has created the resource.
TitleEnter the name of the resource.
BodyEnter the details of the resource.
TeamSelect the team to which this resource belongs to.

Delete a Resource

Deletes a resource.

ConnectionEstablish a connection to your atSpoke account.
Resource IDSelect the Resource ID you want to delete.

Requests

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.

Watch New Requests

Triggers when a new request is created.

Webhook NameEnter a name for the webhook.
ConnectionEstablish a connection to your atSpoke account.
DescriptionEnter the details about the trigger.

Watch Requests Updated

Triggers when a request is updated.

Webhook NameEnter a name for the webhook.
ConnectionEstablish a connection to your atSpoke account.
DescriptionEnter the details about the trigger.

List Requests

Returns a list of requests.

ConnectionEstablish a connection to your atSpoke account.
FilterSelect the option to filter the request based on the specified filters:
  • Inbox
  • Unassigned
  • Watching
  • Sent
StatusSelect the status of the requests you want to list.
TeamSelect the team whose requests you want to list.
List Request IDsAdd the Request IDs whose details you want to list.
Search QueryEnter the keyword or phrase to list the requests based on the specified query.
AISelect whether you want to use AI to list the requests.
LimitSet the maximum number of requests Integromat should return during one scenario execution cycle.

Get a Request

Gets a request.

ConnectionEstablish a connection to your atSpoke account.
Request IDSelect the Request ID whose details you want to list.

Create a Request

Creates a new atSpoke request.

ConnectionEstablish a connection to your atSpoke account.
SubjectEnter the request subject line.
RequesterSelect the user who is making the request.
BodyEnter the details of the request.
OwnerSelect the user to whom you want to assign the request.
TeamSelect the team to which you want to assign the request.
StatusSelect the request status:
  • Autoresolved
  • Open
  • Resolved
Privacy LevelSelect the request privacy option:
  • Public
  • Private
Request TypeSelect the request type. 

Update a Request

Updates a request.

ConnectionEstablish a connection to your atSpoke account.
SubjectEnter the request subject line.
RequesterSelect the user who is making the request.
BodyEnter the details of the request.
OwnerSelect the user to whom you want to assign the request.
TeamSelect the team to which you want to assign the request.
StatusSelect the request status:
  • Autoresolved
  • Open
  • Resolved
Privacy LevelSelect the request privacy option:
  • Public
  • Private
Request TypeSelect the request type. 

Delete a Request

Deletes a request.

ConnectionEstablish a connection to your atSpoke account.
Request IDSelect the Request ID you want to delete.

Users

List Users

Returns a list of users.

ConnectionEstablish a connection to your atSpoke account.
Search QueryEnter the keyword or phrase to list the users based on the specified query.
StatusSelect the status to list only the users with the specified status:
  • Active
  • Invited
TeamSelect the team whose users you want to list.
LimitSet the maximum number of users Integromat should return during one scenario execution cycle.

Get a User

Looks up a user by email address or ID.

ConnectionEstablish a connection to your atSpoke account.
Search BySelect the option to choose the user whose details you want to retrieve:
  • By Email
  • By ID
EmailSelect the user's email address whose details you want to retrieve.
User IDSelect the User ID whose details you want to retrieve.

Update a User

Updates a user.

ConnectionEstablish a connection to your atSpoke account.
User IDSelect the User ID whose details you want to update.
Display NameEnter the user's name as it appears in the account.
Phone NumberEnter the user's phone number.
EmailEnter the user's email address.
Unique IDEnter the user's unique ID for identification.
Job TitleEnter the user's job position. For example, Product Manager.
LocationEnter the user's work or home address.
DepartmentEnter the user's department in which he works. For example, Engineering.
ManagerEnter the user's manager name.
Start DateEnter the user's job start date. See the list of supported date and time formats.

Other

Make an API Call

Performs an arbitrary authorized API call.

ConnectionEstablish a connection to your atSpoke account.
URL

Enter a path relative to https://api.askspoke.com/api. For example: /v1/users

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.

HeadersEnter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query StringEnter the request query string.
BodyEnter the body content for your API call.

Example of Use - List Users

The following API call returns all the users from your atSpoke account:

URL:
/v1/users

Method:
GET

atspoke3.png

Matches of the search can be found in the module's Output under Bundle > Body > results 
In our example, 3 users were returned:

atspoke2.png

 

Popular use cases from our blog

slack-automation-illustration

Slack Automation: 20 Free Templates to Get You Inspired

google-sheets-automation-alt

Google Sheets Automation for Ecommerce: 23 Free Templates

tweet-automation-illustration

How to Get Someone's Tweets Before Anyone Else Does

onboarding-automation-with-integromat-alt

How to Automate Employee Onboarding in Minutes with Integromat

shopify-order-to-manufacturer-illustration-alt

How to Auto Send Shopify Orders to Dropshipping Suppliers [Guide]

strava-exercise-to-google-sheets-illustration

Like a Champ: How to Save Strava Activities to Google Sheets

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.