Workato · API platform

access to this API has been disallowed

Short answer

A Workato API platform endpoint returns 401 with the message access to this API has been disallowed when there is a problem with the API token, the request configuration or the access policy. It is also returned when the request URL is incorrect or the endpoint is not active.

VerifiedLast verified

01Error text

Workato error
401 Unauthorized
access to this API has been disallowed

02Likely causes

  • There is a problem with the API token or the request configuration, or the request violates the access policy.
  • The request URL is incorrect. Some requests to an incorrect URL are returned as 401 and not 404.
  • The endpoint is not active.

03How to fix it

  1. Check that the request sends the API token in the header the endpoint expects, with the correct header name.
  2. Check the request URL against the endpoint's URL, and confirm the endpoint is active.
  3. Confirm the client's access policy allows the request.
  4. Export the API logs and read the Status details column. It narrows the cause: 4011 Unrecognized token, 4012 Missing token, 4013 Invalid credentials, 4014 Endpoint not found, 4040 Recipe is inactive.
  5. Fix what the status detail points to: correct the token for 4011, add or rename the token header for 4012, renew expired JWT or OAuth 2.0 credentials for 4013, correct the path for 4014, and start the API recipe for 4040.

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.