Troubleshooting

Common errors and step-by-step fixes for InstantDM issues.

Flow failed to publish

  • Make sure the flow has a name (not "Un-named").
  • Ensure at least one trigger is configured and enabled.
  • Check that all edges connect to existing nodes.

AI node requires API key

Go to Settings → AI Configuration, enter your OpenAI or Anthropic API key, click Save, then try publishing again.

Automation disabled

Check Settings → Automation Controls. The global toggle, DM toggle, or comment toggle may be OFF. Also check the individual automation's toggle.

Rate limit exceeded

Your account has hit the hourly automation limit. InstantDM automatically queues and retries. Consider upgrading or enabling Smart Slowdown Mode.

Webhook delivery failed

  • Verify your webhook URL is correct and accessible.
  • Check that the receiving server returns a 200 status code.
  • Verify your webhook secret matches on both sides.
  • Make sure your plan includes API & Webhook access.

Connection expired / Token expired

Go to Settings → Instagram Connect, click Disconnect, then Connect Instagram again to get a fresh token.

Account not listed during connection

  • Your Instagram account must be a Business or Creator account.
  • The Instagram account must be linked to a Facebook Page.
  • Try logging out of Facebook completely and re-doing the OAuth flow.
  • Check Facebook → Settings → Business Integrations for all four permissions.

DMs not sending / Automation not firing

  • Check that the automation is toggled ON.
  • Verify trigger words match what users are sending.
  • Check Dashboard → Recent Automation Log for error messages.
  • Ensure your Instagram account is still connected (no token errors).

Flow Editor canvas is blank

  • Try refreshing the page.
  • Clear your browser cache and cookies.
  • Try a different browser (Chrome is recommended).
  • Check your internet connection.

How to Contact Support

  • WhatsApp Support — Available for Trendsetter Pro, Multi Pro, and Multi Ultra plans.
  • Email — Contact the InstantDM support team via the email on the website.
  • In-app help — Check the Home page for tutorial videos and help articles.

When contacting support, include your account email, the specific error message, screenshots, and your current plan name.

← Back to How-To Guide Index