Overview
This article catalogs the errors a subscriber may encounter while using the Jotform integration. Most errors surface in the iPaaS.com error logs and originate from the response Jotform returns when a request cannot be completed. Each error carries a stable code you can search for on this page (for example, JTFM-EXTN-1001): the Jotform integration codes have three segments (JTFM, a category, and a number), while platform errors raised by the iPaaS.com API itself use two segments (for example, EXTN-1002), so the number of segments tells you which catalog to look in. Behaviors that are not errors — for example, a form field whose value cannot be extracted is skipped and the submission continues — are described in the Jotform to iPaaS.com Customer Mapping Documentation and Jotform Integration Known Limitations documents rather than here.
iPaaS.com categorizes errors by families. You can learn more about that categorization at Understanding iPaaS.com API Error Codes.
Supported Flows
Customer Submission (Jotform to iPaaS.com)
Error Collection
Customer Submission (Jotform to iPaaS.com)
A Request to Jotform Did Not Complete Successfully
JTFM-EXTN-1001 - Error calling Jotform CallWrapper.{action}: {Jotform response} (Http Code: {code})
Description: When Jotform cannot complete a request, the integration records the failure along with the HTTP status code Jotform returned. That code indicates the cause. The most common causes are:
Invalid or unauthorized API key (commonly HTTP 401): the API Key on the subscription is incorrect, was regenerated in Jotform, or was revoked.
Daily API limit reached (commonly HTTP 429): Jotform enforces a per-plan daily API request limit, after which further requests are rejected until the limit resets.
Submission not found (commonly HTTP 404): the requested submission no longer exists in Jotform.
Service temporarily unavailable (HTTP 5xx) or a connectivity error, in which case the raw connectivity message is logged.
Resolution:
For an authorization error, confirm the API Key on the Jotform subscription settings page matches a current key in your Jotform account (Account → API); create a new key in Jotform and update the setting if needed.
For a daily-limit error, wait for the limit to reset, stagger large jobs, or upgrade the Jotform plan. See Jotform's API documentation for the per-plan limits.
For other errors, confirm the submission exists and the API Url is correct. If the error persists after checking these, your MiSP (managed integration service provider) can review the subscription configuration and, if they confirm an integration fault, raise it with iPaaS.com Support.
