Troubleshooting

Running into issues? Find solutions to common problems below.

Webhook Issues

Leads aren't appearing after form submission

Check these things:

1. Verify your webhook URL:
   • Go to Lead Follow-up Settings in your dashboard
   • Copy the full webhook URL (including ?key=...)
   • Update it in your form settings
2. Test the webhook:
   • Visit your webhook URL in a browser
   • You should see: "Webhook key is valid. Ready to receive leads."
   • If you see "Invalid webhook key", copy the URL again from settings
3. Check field names:
   • Your form must have a field named name or Name (required)
   • Email and phone are optional
4. Check your form platform:
   • Make sure webhooks are enabled
   • Verify the webhook URL is saved
   • Check if your form requires a paid plan for webhooks

Getting "Missing webhook key" error

Your URL is missing the key parameter. It should look like:

https://studioflows.app/api/leads/webhook?key=abc123...

Not:

https://studioflows.app/api/leads/webhook

Getting "Invalid webhook key" error

Your webhook key is incorrect. Get a fresh copy from Lead Follow-up Settings and update your form.

Getting "Name is required" error

Your form isn't sending a name field. Either:

• Rename your form's name field to name
• Use Zapier to map your field to name

Notification Issues

Not receiving Discord notifications

1. Verify webhook URL: Make sure you pasted the full Discord webhook URL
2. Check Discord channel: Ensure the webhook is set to the correct channel
3. Test the webhook:
   • Go to StudioFlows settings
   • Click "Test Notification"
   • Check if a message appears in Discord
4. Check Discord permissions: The webhook needs permission to post in the channel

Not receiving email notifications

1. Check spam folder: Emails from StudioFlows might be filtered
2. Verify email address: Make sure the email in settings is correct
3. Add to contacts: Add notifications@studioflows.app to your contacts

Not receiving Slack notifications

1. Verify webhook URL: Slack webhooks start with https://hooks.slack.com/services/...
2. Check the channel: Make sure the webhook is configured for the right channel
3. Webhook still active: Slack webhooks can be disabled - check in Slack app settings

Login Issues

Can't log in to my account

1. Check email: Make sure you're using the email you signed up with
2. Reset password: Click "Forgot password" on the login page
3. Check for typos: Passwords are case-sensitive
4. Clear browser cache: Try incognito/private mode

Verification email not received

1. Check spam/junk folder
2. Wait a few minutes (emails can be delayed)
3. Try signing up again with the same email
4. Contact support if still not working

Dashboard Issues

Dashboard is loading slowly

• Check your internet: Try refreshing or testing other websites
• Clear cache: Press Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
• Try another browser: Chrome, Firefox, or Safari
• Disable extensions: Some browser extensions can interfere

Dashboard shows "Loading..." forever

1. Hard refresh the page (Cmd+Shift+R / Ctrl+Shift+R)
2. Clear browser cache and cookies
3. Try incognito/private mode
4. If still stuck, you may need to log out and back in

Changes aren't saving

• Check for error messages
• Make sure all required fields are filled
• Try refreshing and making the change again
• Check your internet connection

Photo Processing Issues

Upload failing

• File size: Max 50MB per image, 500MB total
• File format: JPG, JPEG, PNG, or HEIC
• Internet connection: Large uploads need stable connection
• Browser: Try Chrome or Firefox if having issues

Processed images look wrong

• Crops: Use the preview sliders to adjust before finalizing
• Quality: Output is optimized for web - originals are preserved
• Colors: Check if your original has an unusual color profile

Still Need Help?

If your issue isn't listed here:

1. Check our FAQ for more answers
2. Search the support documentation using the sidebar
3. Email support with:
   • Description of the issue
   • What you've already tried
   • Screenshots if helpful
   • Your account email