API error

Topic summary

Main issue: Requests to the Shopify Admin GraphQL endpoint fail with an SSL handshake error: “Max retries exceeded… [SSL: SSLV3_ALERT_HANDSHAKE_FAILURE]”. This blocks the poster from proceeding.

Context: An SSL/TLS handshake failure means the secure connection cannot be established during initial negotiation (often due to protocol/cipher mismatches, network filtering, or client configuration).

Latest guidance:

  • Test the same GraphQL call using an API client (e.g., Postman) to isolate the problem.
  • If it also fails there, try a different network and check firewall, proxy, or other local settings that could be blocking or inspecting TLS traffic.
  • If it succeeds in the API client, investigate the app’s environment: server configuration (timeouts, TLS settings) or issues in the HTTP/GraphQL library being used.

Status: No resolution yet; actionable troubleshooting steps provided. Key next actions are network/client isolation and configuration checks to pinpoint whether the issue is environmental or application-specific.

Summarized with AI on December 30. AI used: gpt-5.

Hi. Today I’m getting the error while posting graphql query.

"HTTPSConnectionPool(host=‘host’, port=443): Max retries exceeded with url: /admin/api/2024-01/graphql.json (Caused by SSLError(SSLError(1, ‘[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] sslv3 alert handshake failure (_ssl.c:1000)’))).

Will you please help me with this? It’s so frustrating because of this error i can’t do further process.

Hey @AjeetSingh1 ,

Looking at the error, it seems that there’s an issue connecting, and something likely timing out. It’s hard to say for sure.

I would recommend testing using an API client like postman to see if the error persists there. If so, try a different network and look in to possible firewall or other local settings that could be blocking these requests from going through.

If it works in an API client, then the issue would be somewhere further down the line. Possibly server configuration settings timing out, or if you’re using a library for your app development, there could be an issue there.

Hope that helps with atleast some next steps to try!

  • Kyle G.