Troubleshooting the Spellbook Licensing API

We’re sorry you’re having an issue validating your license. 🙁

There are multiple reasons license activation might fail. Below are some known ones;

  • When license registration fails with the error No route was found matching the URL and request method, it is often caused by an unintended trailing slash on the license validation URL. This trailing slash triggers a 301 redirect, and when the browser follows the redirect, it changes the original POST request into a GET request. Since the license validation endpoint only accepts POST requests, the server returns a 404 error. Trailing slashes can be added automatically by SEO or redirect plugins that enforce them on all URLs, or by rules in an .htaccess file.

  • When you encounter the error Failed to register product, the first step is to try refreshing your license. In Spellbook, navigate to the Licenses tab. At the top right of the page, click the Refresh Licenses button. This action often resolves registration issues by ensuring that your license status is up to date with the server.

Provide Logging Information

If none of the above helps, the next step is to provide logging information so we can help troubleshoot the problem.

  1. Follow these instructions from Gravity Forms to enable logging: https://docs.gravityforms.com/logging-and-debugging/
  2. Once logging is enabled, access the Logging tab (Forms › Settings › Logging) and ensure Enable logging and log all messages is checked for Spellbook.
  3. Return to the Licenses page (Forms › Spellbook › Licenses) and click Deactivate.
  4. Re-enter your license key and click Activate License.
  5. Return to the Gravity Forms Logging page and click view log under Spellbook.
  6. Send us the URL to the log via the support form.