I can't access the Headless CMS
Troubleshoot Headless CMS access errors caused by permissions, authorization, or VTEX IO CLI environment configuration issues.
Keywords: Headless CMS, FastStore, CLI
FastStore users may encounter the following errors after using the commands faststore cms-sync or vtex cms sync.
| Error message | Possible cause | Solution |
|---|---|---|
Error: Permission denied | The user role doesn't have the required CMS permissions. | Grant user Admin access |
Error: User indicated by VtexIdclientAutCookie is not authorized to access the indicated resource | The user doesn't have access to the required CMS resources in License Manager. | Grant user Admin access |
Error: SyntaxError: Unexpected token | The VTEX IO CLI environment isn't configured correctly. | Check VTEX IO CLI environment |
Solutions
To solve your issue, follow one of the paths below based on the error message displayed in your CLI.
Grant user Admin access
Use this path when the error is related to authorization or permissions in License Manager.
-
Open the VTEX Admin and go to Account Settings > User Roles.

-
Under Roles, select the role associated with the user requesting CMS permissions. For example, Owner (Admin Super).
-
In Products and Resources, click CMS.

-
Make sure both See CMS menu on the top-bar and Settings are checked.
-
Go to the Users section and add the email of the user who needs CMS access.
-
Click
Save. -
Ask the user who requested access to run
faststore cms-syncorvtex cms syncagain. -
Confirm the command runs without
Error: Permission deniedor any authorization errors.
Check VTEX IO CLI environment
Use this path when the error points to CLI execution or environment configuration.
Verify authentication
- Open the terminal and run the
vtex whoamicommand. - Confirm that the displayed account and workspace are the ones expected for CMS sync.
- If you're not logged in, or if the account or workspace is incorrect, run
vtex loginand authenticate with the correct account and workspace.
Update VTEX IO CLI
- Run the
vtex autoupdatecommand in your terminal. - Run the
vtex -vcommand to check if the VTEX IO CLI and Node versions are updated.
Verify the workspace
- Run the
vtex workspace listcommand to see the available workspaces. - If required, switch to the correct workspace with
vtex use <workspace-name>.
Retry the sync in verbose mode
- After adjusting the environment, run the
vtex cms synccommand. - If the error persists, run
vtex cms sync --verboseto get more details about the sync error.
If the issue continues after that, open a ticket with VTEX Support.