OAuth authorization

Everything you should know about the OAuth endpoints

Automator Cloud uses OAuth for authentication.

Authorize

GET https://api.automator.cloud/oauth/authorize

OAuth authorize endpoint

Query Parameters

Name	Type	Description
redirect_uri	string	The redirect uri of your callback endpoint
scope	string	A list of scopes seperated by '+'
state	string	The OAuth state of this request
client_id	string	The ID of your OAuth application

302 A redirect to our authorization gate and to your backend afterwards

400 When you provide a bad scope, bad state or bad redirect_uri

Token

POST https://api.automator.cloud/oauth/token

OAuth token endpoint This endpoint only accepts requests with header Content-Type: application/x-www-form-urlencoded

Request Body

Name	Type	Description
refresh_token	string	Your OAuth refresh token recieved from previous token endpoint call. Required if grant_type is refresh_token
code	string	Your OAuth auth code received from authorization callback. Required if grant_type is authorization_code
grant_type	string	The type of your token grant. Must be either authorization_code or refresh_token
client_secret	string	The client secret of your OAuth application
client_id	string	The id of your OAuth application

200 Token was created successfully

{
    "access_token": "<accessToken",
    "token_type": "Bearer",
    "refresh_token": "refresh_token",
    "expires_in": "3600" // Amount of seconds until expiration of token
}

400 When grant_type, code or refresh_token is wrong/missing

Scopes

Scope name	Description
room_locators	Gives you access to a users Room Locators
smart_tags	Gives you access to a users Smart Tags