Workato · On-prem agent

Failed to start SDK extension. 520 Connection Failed

Short answer

This error means the SDK handshake between an on-prem extension and the Workato platform failed during startup. Build the extension with JDK 8 and make sure its post() URLs use the correct port.

VerifiedLast verified

01Error text

Workato error
Failed to start SDK extension. 520 Connection Failed

02Likely causes

  • The SDK handshake between the extension and the Workato platform failed to initialize during startup.
  • A missing, wrong or blocked port causes a 520 error.

03How to fix it

  1. Use JDK version 8.
  2. Run ./gradlew jar in the extension project root. The output is in build/libs/.
  3. Make sure post() URLs use the correct port, for example localhost:3000.

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.