Give GSX Users API Privileges in MyAccess

Giving GSX Users API Privileges in MyAccess

Overview

In order to make use of the GSX API integration in PIMS, all users must be given a minimum role of "Technician" with the optional privilege of "Web Services" selected.  This article details how to verify that users have the correct role and privileges make these changes to users in MyAccess.

Step-by-Step Walkthrough

Please note that this function must be performed by someone who is a GSX Administrator for your sold-to account.
Only Apple can grant the Administrator role to Service location staff. Anyone who wishes to become an Administrator must have an existing Admin or authorized individual request an invitation on the user's behalf from Apple via the applicable regional email.  For more information on adding Administrators or updating existing users to the Administrator role, please see GSX Article OP1891.  For additional information about GSX User Roles and Privileges, please see GSX Article OP492.

Verifying That GSX Users Have the Correct Role and Privileges in MyAccess

  1. Log into MyAccess (myaccess.apple.com) using your GSX Apple ID and password.





  2. Click on "My Team"  in the navigation at the top of the page.





  3. Find the user you need to give permissions to in the list of names on the "My Team" page and click on their name.





  4. The "Account Details" page for the user you clicked on will be displayed.  Click on "Global Service Exchange" to view the user's role and privileges for GSX.





  5. The user's "Business Role" must be "Technician" or "Administrator".





  6. If the user's "Business Role" is "Technician", they also need to have "Web Services" listed as one of their privileges under "Optional Privilege(s)".  If the user's "Business Role" is "Administrator", they already have the "Web Services" privilege included automatically as part of their role.



Changing a GSX User's Role and Optional Privileges in MyAccess

  1. Log into MyAccess (myaccess.apple.com) using your GSX Apple ID and password.





  2. Click on "My Team"  in the navigation at the top of the page.





  3. Find the user you need to give permissions to in the list of names on the "My Team" page and click on their name.





  4. The "Account Details" page for the user you clicked on will be displayed.  Click on "Global Service Exchange" to view their role and privileges for GSX.





  5. Click on "Update Access" to update the user's role and privileges.





  6. In the "Update Access" pane, click on the "Business role" drop-down menu in the "Access Role Information" section and select either "Technician" or "Manager".





  7. Click on the "Optional Privilege(s)" drop-down menu to the right of the "Business role" field and check the "Web Services" privilege if it isn't already.










  8. Click the "Submit" button at the bottom-right of the "Update Access" pane.





  9. Another GSX Administrator within your company may need to approve the changes before they are active.

    • Related Articles

    • GSX Integration Onboarding for Weevio Notifier & Scheduler

      Overview Apple uses a complex and highly secure authentication system for their APIs.  This system requires the exchanging of authentication tokens throughout the process of making API calls.  Failure to provide the most recent token during an API ...
    • Updating your GSX API Token for Weevio Scheduler & Notifier

      Overview With the launch of the RESTful GSX APIs, Apple changed authentication to a user-based tokenized system. Starting May 31, 2022, GSX Web Services will limit the maximum duration of token exchanges that may be performed through the token API. ...
    • Configuring GSX User Credentials in PIMS

      Overview With the launch of the RESTful GSX APIs, Apple changed authentication to a user-based tokenized system.  Rather than have a PIMS Administrator manage the credentials for all GSX users, ExecUtron added the ability for each user to manage ...
    • PIMS GSX API Integration

      Since Apple's announcement that their SOAP API's were going offline, there's been a lot of discussion as to what options are available to Apple Authorized Service Providers. We believe that the best option is one which takes advantage of the new REST ...
    • Customer How-To Setup - GSX Settings (AS)

      GSX Settings This section is used primarily for authentication with GSX. GSX Settings Sold-To The Sold-To number is required and is provided to all GSX customers by Apple. This allows access to the GSX API. This is the number provided to a company as ...