The GoToAssist Service Desk quick-start includes:

  1. Register for a Developer Center account.
  2. Obtain a product license for your target LogMeIn product.
  3. Create a developer application in the Developer Center.
  4. Authenticate your accounts and get an access token for API calls.
  5. Make your first LogMeIn API calls.

Working straight through these steps takes roughly 30 minutes.

The instructions below are minimal - no screenshots, and very limited explanations. If you need additional information, check out the Have a Question? widget on the bottom of the page.

If you have problems, contact Global Support

Before you start

These steps assume you have downloaded and installed:

  • Postman as an API test and development portal.

Register for a GoTo developer account

  1. Go to the GoTo Developer Center
  2. On the GoTo Developer home page, click Get an Account, It's Free!
  3. In Create your GoTo ID, enter your name, email, and a password and click Sign up.
  4. You are informed that an email was sent. Open the email and click Verify my email address.
  5. Return to the GoTo Developer page in your browser and click Proceed.

You are registered.

Have access to a GoTo account

Get a GoToAssist account. You can start a 30-day trial, open a full account, or arrange with an existing user to access GoToAssist.

  1. Log in to make sure the account is live.

Create a developer application

  1. In the GoTo Developer Center, click My Apps.
  2. The My Apps page displays. If you already have apps, they are listed here.
  3. Click >Add a new app on the My Apps page.
  4. Enter the App data:
    • App name - for example, GoToAssist API
    • Description - for example, Service Desk
    • API Product - GoToAssist - This selection covers Remote Support, Service Desk, and SeeIt.
    • Application URL (also known as the Redirect or Callback URL) - The landing page where users should end up after logging in. During testing, this may be the Postman application. If so, you would enter the following URL: https://www.getpostman.com/oauth2/callback.
  5. Click Create App
  6. Back in the My Apps page, open the new application.
  7. Copy the Consumer Key and Consumer Secret values:
    • Consumer Key - sample value: Nc2I8YfAkeFaOf4JuKeYBBQJFGfTGmvR
    • Consumer Secret - sample value: GfIKahyRRQIGqau2

Authenticate

  1. In a text editor or in the URL entry area of an active browser tab, enter the following URL, substituting the Consumer Key value for {ConsumerKey}:
https://api.getgo.com/oauth/v2/authorize?response_type=code&client_id={consumerKey}

Becomes, for example:

https://api.getgo.com/oauth/v2/authorize?response_type=code&client_id=Nc2I8YfAkeFaOf4JuKeYBBQJFGfTGmvR
  1. In a browser window, paste the entire string into the URL entry area and press Enter.
  2. You (or your user) is sent to the product sign-in page.
  3. If the user is not already logged in, they sign in with their credentials and must click Allow to allow access for the developer application.
  4. The user is automatically redirected to the redirect URL you defined in the developer center application. The redirect URL has a Response Key added to it:
http://example.com/oauthreturn/?code={responseKey}

Is returned as, for example:

http://example.com/oauthreturn/?code=6a0497c6915ca109e49482bfe2d5c1a5

IMPORTANT: You may see an error on the page such as 404 NOT FOUND. This is not a problem. Look at the URL in the browser. It contains the responseKey you need for the next step.

Get an Access Token

You can now get an access token. This access token can now be used to authorize API requests by setting it in the Authorization header.

  1. Launch the Postman application.
  2. Create a new call in an empty tab as follows:

Postman POST call

Key Value
Call type POST
URL https://api.getgo.com/oauth/v2/token
Headers tab  
Content-Type application/x-www-form-urlencoded
Accept application/json
Body tab  
grant_type authorization_code
code {response code}

 

  1. In the Authorization tab, select OAuth 2.0 from the drop-down TYPE menu.
  2. Select Get New Access Token.
  3. In the dialog that opens, some values may be entered for you already. Make sure to include:
  4. Click Request Token.  (See table of sample responses below.)
  5. In the MANAGE ACCESS TOKENS window, scroll down and click Use Token.

Authorization POST Response

Key Value Description
Token name GoToAssist API token Used by Postman to identify this token in a list of tokens.
Access token EFNw8bGqaPsiFaKeKx8IA5pdcrPX This is the authorization code to pass with API calls.
expires_in 3600 Time before token expires in seconds (60 minutes).
Token type Bearer Identifies the token as Basic, Digest, Bearer, etc.
refresh_token pMyCY089lyHOmGBByGgRFJwgsFAKegiu Good for 30 days, this token value can be used to obtain a new access token and refresh token pair.
account_key 36686902397076889999 Your company’s account number with LogMeIn.
account_type   Typically blank.
email gidget.spinner@lookinggood.com The organizer's email (login) for their LogMeIn account.
first_name Gidget The organizer's first name.
last_name Spinner The organizer's last name.
organizer_key 84312345678123456789 The organizer’s identity in GoToAssist.
version 3 The current API release version.

This access token will now be available in Postman to authorize API requests for your GoToAssist Service Desk application. You can now use the token to run any of the GoToAssist APIs.

Make a successful API call

  1. Click to get the latest GoToAssist Postman Collection. The Collection should open in your Postman application.
    • NOTE: If the Collection does not open, copy the link and choose the Import button in Postman, and use the Import from Link option.
  2. Choose the GET Companies API call.
  3. Make sure the URL contains either the base URL (https://api.getgo.com/) or a properly resolved variable for {{baseURL}}.
  4. On the Authorization tab:
    1. Make sure Type is set to OAuth 2.0.
    2. Choose Available Tokens.
    3. Select the token you just created.
  5. On the Body tab:
    1. A draft Body of this call is included in the Postman Collection. You can modify the content as needed.
  6. Click Send. In the Body section of the Postman window, you should see Status: 200 OK. The API body for the call will show data if any is sent.