references/learnings.md

• A) Build a form — new form, template selection, field types, conditional logic
• B) Collect payments — Stripe, PayPal, Square, or other gateway integration
• C) Set up workflows — approval chains, conditional branches, notifications
• D) Use the API — create forms/submissions programmatically, webhooks, SDK setup
• E) Fix a problem — form not submitting, payment failing, logic not working, limits hit
• F) Integrate with other tools — CRM sync, Zapier/Make, email platform, webhook to external system
• G) Something else — tables, PDF editor, app builder, reports, e-signatures

• A) Free (5 forms, 100 submissions/mo)
• B) Bronze (25 forms, 1K submissions/mo)
• C) Silver (50 forms, 2.5K submissions/mo)
• D) Gold (100 forms, 10K submissions/mo, HIPAA)
• E) Enterprise (unlimited forms, 10M submissions/mo)
• F) Not sure

• Form design: Start from a template (10,000+ available), then customize. Use conditional logic sparingly — conflicting show/hide conditions are the #1 support issue.
• Payments: Only one payment gateway per form. If you need both Stripe and PayPal, create two forms or use Jotform's built-in payment selector widget.
• Submissions: If hitting limits, archive old submissions or upgrade. Submissions count resets monthly.
• API: Webhooks only fire on form submit button — NOT on API-created submissions. If you need API-triggered notifications, poll the submissions endpoint or use a Zapier trigger instead.
• Workflows: Use If-Else condition elements for branching. Test each branch individually before adding complexity.

references/learnings.md

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.

1. One payment gateway per form — you cannot have both Stripe and PayPal on the same form. Need both? Create separate forms or use Jotform's payment selector widget.
2. Webhooks don't fire on API submissions — submissions created via

   POST /form/{formID}/submissions

   do NOT trigger webhooks. Only form submit button clicks trigger them.
3. Webhook 30-second timeout — if your endpoint takes longer than 30 seconds to respond, the webhook will fail. Process async.
4. Conditional logic conflicts — multiple show/hide conditions on the same field can conflict silently. Test after every new condition.
5. HIPAA requires Gold plan — Gold (€129/mo) is the minimum for HIPAA compliance. Free through Silver plans cannot be used for PHI.
6. Free plan: 5 forms, 100 submissions/mo — this resets monthly but is strict. Archived submissions still count toward storage.
7. EU API endpoint — if your account is in the EU, use

   eu-api.jotform.com

   not

   api.jotform.com

   . Wrong endpoint = 401 errors.
8. Form submission "Please Wait" freeze — usually a browser issue. Clear cache, try incognito, disable extensions. If embedded, check for JavaScript conflicts with the host page.

• /sales-funnel

  — Full funnel strategy, page sequencing, and traffic-to-sale architecture.

• /sales-checkout

  — Checkout optimization — upsells, order bumps, payment plans, cart abandonment.

• /sales-integration

  — Connect Jotform to CRM, email, or other tools via webhooks, Zapier/Make, or API.

• /sales-email-marketing

  — Email marketing after form-based lead capture.

• /sales-lead-score

  — Lead scoring models using form submission data as behavioral signals.

• /sales-lead-routing

  — Route form submissions to the right sales rep or team.

• /sales-do

  — Not sure which skill to use? The router matches any sales objective to the right skill. Install:

  npx skills add sales-skills/sales --skill sales-do

1. Check browser — clear cache, try incognito mode, try a different browser.
2. Verify Stripe account is active and not in test mode (unless testing).
3. In Form Builder → Settings → Integrations → search "Stripe" → click to connect.
4. If spinning persists, disconnect any existing payment integration first (green dropdown → Disconnect), then reconnect Stripe.
5. Confirm the form has at least one payment field (Product List or Payment element) — Stripe won't connect to forms without a payment element.

1. Go to Settings → Conditions → review all Show/Hide conditions.
2. Look for conflicting conditions — two conditions targeting the same field with different triggers.
3. Disable all conditions, then re-enable one at a time, testing after each.
4. If using "is equal to" conditions on dropdown fields, ensure the value matches exactly (case-sensitive).
5. Save and test in preview mode, not the builder view.

1. Create the purchase request form with an amount field.
2. Go to Workflows → create new workflow from the form.
3. Add an If-Else Condition element after the form submission trigger.
4. Set condition: "If [Amount field] is greater than 500" → route to Approval element (assign manager email).
5. Else branch → route to Email notification element (auto-approve, notify requester).
6. Add email notifications on both branches to confirm the outcome.

• Most common cause: browser extension conflict or stale cache.
• Try: incognito mode, different browser, clear cache and cookies for jotform.com.
• If the form is embedded on another site, check for JavaScript errors in the browser console — host page scripts can interfere with Jotform's submission handler.
• If the issue is intermittent, check your submission count — hitting the monthly limit silently blocks new submissions on some plans.

• Log out of Jotform, clear browser cache, log back in, and retry the connection.
• Only one payment gateway per form — if another gateway is already connected, disconnect it first.
• Ensure your Stripe/PayPal account is fully activated (not just created) — unverified accounts can't connect.
• Try a different browser — Chrome extensions (especially ad blockers) can block the OAuth popup.

• Verify the webhook URL is correct in Settings → Integrations → WebHooks.
• Test with a simple endpoint (e.g., webhook.site) to confirm Jotform is sending.
• If submissions are created via the API, webhooks will NOT fire — this is a known limitation. Use Zapier's "New Submission" trigger or poll the API instead.
• Check the 30-second timeout — if your endpoint is slow, the webhook will fail silently.