If you have not already created your API Client ID, you'll need to do that to use this tool.
Sorry in advance for this one. It's a beast, but you only have to do it once ;)
- Visit the API Client Tab on your SFCC Account Manager
*
- Click
Add API Client
button in the top right - For
Display Name
, enter something that identifies your Sandbox, e.g.,ods-jane-doe
- For
Description
, write something helpful, e.g.,ODS API User for Jane Doe
- Enter a secure password for
Password
( this is yourSFCC_OAUTH_CLIENT_SECRET
) - For
Access Control
, check theEnabled
checkbox - Click the
Add
button onOrganizations
- Select the checkbox next to your Organization's name
- Click the
Add
button to Assign the Organization - Click the
Add
button onRoles
- Select the checkbox for
Sandbox API User
- Click the
Add
button to Assign the Role - Click the Filter Icon to the right of the
No role scope defined
- Select your Organization from the list
- Choose your Sandbox from the select list
- Click the
Add
button to add your Sandbox as a Sandbox API User - Set
Token Endpoint Auth Method
toclient_secret_post
- Set
Access Token Format
toUUID - Deprecated. JWT recommended
- You can leave everything else with default settings
- Press
Save
After Saving, you will be returned to the API Clients ID list. Find the one you just created and open it. At the top of the page, you will see your API Client
.
Screenshot:
*
NOTE: If you do not see the API CLient
tab after logging into your Account Manager, contact your Administrator to get access. You will not be able to use this tool without these credentials. They may be able to set this up for you using the instructions above if they are unwilling to give you direct access.
SFCC_OAUTH_CLIENT_ID
( API Client ID )SFCC_OAUTH_CLIENT_SECRET
( Password used when creating the Client ID )SFCC_SANDBOX_ID
( Sandbox UUID used by this tool )