How to Login to APIv3

Art Centres will need to update any existing connections to SAM via the new APIv3 as they migrate. 
Old connections will no longer work. Please be aware that the new API will replace the existing SAM API (v1) and API (v2).

The API documentation apiv3.sam.org.au outlines the key functionality required to manage an online store focused on artworks, editions, and related products. It includes endpoints for SAM searches, stock availability checks and updates, customer creation, and sales order management.

Developers wishing to build custom connections for Art centres will have access to the APIv3 via the UAT Environment (Web Testing site). This is where you can test the API and new integrations. 

How to access the new SAM API (v3)

• API v3 access is granted only through a support request. (email help@sam.org.au)
• Users cannot create accounts directly through the system.
• Credentials are issued manually and require a mandatory password reset before first login.

Login Process

• Submit a support request to enable APIv3 access.
   
• Once the request is approved, the user will receive an email containing:
  • Username
  • Temporary password
  • Password reset link
     

Click the password reset link and reset the password using the provided temporary password:

Enter the Temporary Username & Password provided in the email:

Enter a New Password & Given Name (which will become your username):

After resetting the password, test the call to the API v3 login endpoint using V3 Access Link (https://apiv3.sam.org.au/#/).

Enter your:

• Newly created Username
• Newly created Password
• Select the relevant environment (UAT – Testing; PROD – Live)