Troubleshooting
This page is the central triage guide for the current DripDrop product surface. Use it to route a problem quickly, identify the likely feature area, and move to the right detailed page. It intentionally avoids re-documenting full setup steps.
Getting Started
You are stuck in email verification
- Confirm you are checking the same email address you used to sign up.
- Check spam or quarantine folders.
- Try signing in again after clicking the verification link.
You cannot see Admin
Admin is only available to the account owner. No other role or access level grants it. Ask the owner to perform admin tasks such as connecting providers.
You cannot choose a provider in a flow block
- Confirm the provider was created in Admin → Integrations.
- Confirm the provider supports the block type you are configuring, such as Email or Text Message.
You cannot enroll a contact
- Confirm the contact exists in Contacts.
- Confirm the flow is saved and has no blocking validation errors.
- Use a test contact first so you can safely retry.
The flow editor shows errors
- Open the validation or errors area.
- Select the block named in the error.
- Complete missing provider, template, timing, or condition fields, then save again.
Dashboard Overview
I only see Select a Plan
Your account does not currently have an active subscription. Choose a plan to continue. If you just completed checkout, wait a moment and refresh if the dashboard does not update.
I cannot open a flow editor
Flow editor routes require an active subscription. Confirm that your account has a plan selected.
I do not see Admin
Admin appears only for account owners in the current app shell. If you need access, ask the account owner to make the change or perform the admin task.
A page shows no data yet
Empty states are expected for new accounts. For example, Flows may show no flows yet, Stats may show no messages or enrollments yet, and History may show no events recorded yet.
I was sent back to login
Protected dashboard routes require an active sign-in session. Sign in again to continue.
Integrations
Provider is missing from a flow block
- Confirm the provider was created under Admin → Integrations.
- Confirm the provider type matches the block type you are configuring.
- Refresh the page after saving a new provider if the block was already open.
Credentials or OAuth connection fails
- Check the provider account credentials, OAuth permissions, API key, app password, webhook signing key, or selected phone/messaging resource, depending on the provider type.
- For OAuth providers, reconnect the account if authorization expired or was revoked.
- For API-key providers, create a fresh key in the provider console if the existing key may be invalid, then save or verify the provider again.
- For webhook providers, use Configure Webhook when auto-configuration is available, or copy the webhook URL into the provider console and then use Verify Webhook.
- For AI providers, use Verify API Key and confirm the account has access to the selected model.
Sends fail after setup
- Check History for send errors.
- Confirm the provider account is active and allowed to send through the selected channel.
- Use a test contact before enrolling real contacts.
Integrations / Gmail
Google authorization does not complete
- Confirm you are signing in with the intended Google account.
- Retry the connection from Admin → Integrations.
- If authorization was revoked, reconnect the Gmail provider.
App password is rejected
- Confirm the username matches the Gmail account that created the app password.
- Generate a new app password if the old one was copied incorrectly or revoked.
Gmail is not available in a flow block
- Confirm the Gmail provider exists under Admin → Integrations.
- Confirm you are configuring an email block, not an SMS or AI block.
- Refresh the Flow Editor if the provider was created in another tab.
Email sends fail
- Check History for the send error.
- Confirm the connected Google account is still active and authorized.
- Test with a contact you control before sending to real contacts.
Integrations / Outlook
OAuth problems
- If the popup closes early or authorization is denied, restart the OAuth flow and complete the Microsoft consent step again.
- If the provider shows an expired authorization state, use Reconnect to refresh mailbox access.
- If OAuth succeeds but inbound setup fails, check whether Microsoft Graph mailbox notifications are allowed for the account and whether the connected mailbox still has valid access.
App password problems
- If save or send fails, confirm you used an app password rather than the normal account password.
- If you cannot create an app password, verify that two-step verification is enabled and that your Microsoft account or tenant still permits app passwords.
- If the mailbox address is wrong, update it to the exact Microsoft mailbox that should send from Drip Drop.
Inbound/reply problems
- If replies do not appear, verify the provider was connected with OAuth and that the Outlook inbox subscription is active.
- If the inbound status looks expired or not configured, retry setup from the provider form.
- If a reply reaches the mailbox but is not linked to the expected outbound message, test again with a fresh Drip Drop send so the message threading headers are present.
Integrations / SendGrid
API key and permissions
- If saving works but webhook configuration fails, check whether the API key has the correct Event Webhooks or Inbound Parse permissions.
- If sending fails, confirm Mail Send has full access and the API key is still valid.
Webhook and verification problems
- If the webhook cannot be verified, compare the URL in SendGrid with the URL shown in Drip Drop.
- If signed webhook validation fails, confirm the verification key was saved and that SendGrid is actually sending signed requests.
- If verification looks manual or delayed, send a test event and check again after SendGrid has delivered traffic.
Tracking problems
- If opens are missing, confirm Track Opens is enabled in the provider settings and that you are expecting SendGrid event tracking rather than only internal tracking.
- If clicks are missing, confirm Track Clicks is enabled and that messages are using links that SendGrid can track.
Inbound parse problems
- If replies never appear, verify the Parse Hostname is configured in SendGrid and that the required MX or DNS routing is in place for that hostname.
- If Inbound Parse is enabled in Drip Drop but not configured in SendGrid, complete the manual provider-side setup.
- If replies arrive but do not match the expected outbound message, test again with a fresh send so the tracking headers are present.
Integrations / Mailgun
API key, domain, and auth problems
- If setup fails immediately, confirm the Mailgun API key is valid and has access to the intended account/domain context.
- If sending fails, confirm the sender domain is set and matches the Mailgun domain you intend to use.
- If the wrong domain was entered, update it before debugging webhook or route behavior.
Webhook and verification problems
- If not all events are arriving, check whether every needed event type is configured on the Mailgun domain.
- If another set of webhook URLs is already present, review how many URLs are already attached for that event type.
- If signed validation fails, confirm the webhook signing key is saved and that Mailgun is sending the expected token, timestamp, and signature fields.
Tracking problems
- If opens are missing, confirm Track Opens is enabled and that you are expecting Mailgun event tracking rather than only internal tracking.
- If clicks are missing, confirm Track Clicks is enabled and that the messages are using links Mailgun can track.
Inbound routing problems
- If replies never appear, verify the parse domain is configured correctly and that MX or DNS routing for that hostname points to Mailgun.
- If the route exists but forwards to the wrong URL, update the forward action to the Drip Drop inbound endpoint.
- If replies arrive but do not match the expected outbound message, test again with a fresh send so the tracking headers are present.
Integrations / Twilio
Credentials and resource problems
- If the provider cannot connect, confirm the Account SID and Auth Token are correct.
- If no phone numbers appear, make sure the Twilio account actually owns a compatible number.
- If the wrong number was selected, choose the exact number that should send and receive messages for Drip Drop.
Webhook problems
- If Drip Drop reports a conflict, check whether the number already points to another webhook URL in Twilio.
- If inbound messages or status updates do not appear, verify the webhook URL and callback settings on the Twilio number.
- If signed validation fails, check whether the saved auth token still matches the Twilio account sending the webhook.
Inbound and sending problems
- If messages send but replies do not appear, test the inbound webhook path with a real SMS to the configured Twilio number.
- If status updates are missing, verify the status callback is pointed at Drip Drop as expected.
Integrations / Telnyx
Credentials and profile problems
- If the provider cannot connect, confirm the API key and public key are correct.
- If no messaging profiles appear, make sure the Telnyx account has accessible profiles and that the API key can list them.
- If the wrong profile was selected, switch to the one that should own inbound and outbound messaging for Drip Drop.
Webhook problems
- If Drip Drop reports a conflict, check whether the selected messaging profile already points to another webhook URL.
- If inbound messages or status events do not appear, verify the webhook URL on the selected messaging profile in Telnyx.
- If signed validation fails, confirm the saved public key matches the Telnyx account sending the webhook.
Inbound and sending problems
- If messages send but replies do not appear, test the inbound webhook path with a real SMS through the selected profile.
- If sending fails only on one profile, confirm that profile is configured for the numbers or traffic you expect.
Integrations / Claude
API key and authentication problems
- If the provider does not validate, confirm the Anthropic API key is correct and still active.
- If the key looks right but access still fails, check whether the Anthropic account or workspace has billing or access restrictions.
Model availability problems
- If no models appear, confirm the provider validated successfully and the Anthropic account has access to model listing.
- If the expected model is missing, it may not be enabled for that Anthropic account or it may have been renamed or retired.
- If a saved model later stops working, choose a different available model and retry the action.
Rate limits and provider errors
- If AI actions fail intermittently, Anthropic rate limits or temporary service issues may be the cause.
- If the provider returns permission or bad-request errors, re-check the API key and selected model rather than treating it like a generic network problem.
Integrations / ChatGPT
API key and authentication problems
- If the provider does not validate, confirm the OpenAI API key is correct and still active.
- If the key looks right but access still fails, check whether the OpenAI account has billing, quota, or permission restrictions.
Model availability problems
- If no models appear, confirm the provider validated successfully and the OpenAI account can list models.
- If the expected model is missing, remember that Drip Drop only shows supported chat-capable model families in this picker.
- If a saved model later stops working, choose a different available model and retry the action.
Rate limits and provider errors
- If AI actions fail intermittently, OpenAI rate limits, quota issues, or temporary service problems may be the cause.
- If the provider returns a bad-request or permission error, re-check the selected model and API access rather than treating it like a generic network problem.
Integrations / OpenRouter
API key and authentication problems
- API key rejected: create or copy a current key from OpenRouter and check that the account can access the API.
Model availability problems
- Model missing: refresh the provider model list later; availability is filtered and cached, and the OpenRouter account may not expose every model.
Rate limits and provider errors
- Request denied or out of credits: review OpenRouter permissions, credits, limits, and model availability.
- Requests time out or fail temporarily: retry after checking OpenRouter service status and the provider’s returned error.
Integrations / Sendblue
Credentials and resource problems
- Credentials rejected: verify the API Key ID and API Secret Key in Sendblue Dashboard and save them again.
- No line appears: confirm the Sendblue account has an available line and that the credentials can list it.
Webhook problems
- Inbound messages do not arrive: verify the receive webhook is enabled and the provider shows inbound as configured.
- Webhook rejected: check that the saved Webhook Secret matches the sb-signing-secret value sent by Sendblue.
Inbound and sending problems
- Delivery status is missing: confirm the provider is sending status callbacks and review the message event in Drip Drop.
Integrations / Generic Email
SMTP problems
- If sending fails, check the SMTP host, port, username, and password first.
- If authentication fails, verify whether the mailbox provider requires an app password instead of the normal account password.
- If the mailbox provider expects SSL or TLS settings outside the defaults, update the provider settings to match.
IMAP problems
- If replies never appear, confirm Enable IMAP is on and that the IMAP host and port are correct.
- If the mailbox is reachable but replies still do not appear, check the folder setting and any archive behavior that may move messages unexpectedly.
- If SSL or TLS is mismatched, IMAP can fail even when the mailbox credentials are correct.
Reply matching problems
- If a reply reaches the mailbox but is not linked to the expected outbound message, test again with a fresh Drip Drop send so the reply headers are present.
- If the mailbox receives many unrelated messages from the same sender, fallback matching may not behave the way you expect without clean reply headers.
Contacts
Import file is not accepted
- Confirm the file is a CSV; other file types are not accepted.
- Confirm the required first_name column is present.
- Check that email and phone values are in valid formats, then review any field-level or server validation messages.
A contact will not save
- Add at least one email address or phone number.
- Fix any field-level validation messages.
- Check required custom fields if your workspace uses them.
The flow dropdown is empty
- Select one or more contact rows first; the Add to flow dropdown is hidden until contacts are selected.
- Confirm a flow exists and is available for enrollment. If the flow was just created, refresh the Contacts page and try again.
- If enrollment fails, confirm the selected contacts have the channel required by the flow blocks, such as an email address for email steps or a phone number for text-message steps.
Templates
No templates are visible
- Clear search, type, status, or tag filters.
- Confirm you are in the correct workspace.
Template is missing from a flow block
- Confirm the template type matches the block type.
- Check whether the template status needs to be Active for the place you are selecting it.
- Refresh the flow editor if the template was created in another tab.
Variables are not replaced
- Check the variable spelling and braces.
- Confirm the contact or custom field has a value.
- Preview with sample contact data before sending.
AI assistant is not available
- Confirm an AI provider is connected if your workspace uses AI-assisted template writing.
- Check Settings for AI enablement and Admin → Integrations for ChatGPT or Claude provider setup, depending on your workspace configuration.
Flow Templates
I do not see a provider
Only providers that support the required channel or method are offered. Connect providers in Settings or Integrations, then return to the template.
I cannot add the template
Check for:
- Flow limit issues
- Duplicate flow name
- Invalid provider or sender
- Invalid Notify recipients
- Archived or incompatible custom fields
- Missing required template choices
A block is marked incomplete after adding
This is expected when provider, sender, message template, custom field, or recipient data was skipped. Open the block in the Flow Editor and complete the missing fields.
Billing and Plans
I don’t see a subscription
If Billing displays No Subscription, select a plan and complete checkout. Refresh the page after returning to DripDrop.
I can’t change my plan
Confirm that:
- You are the account owner.
- Your subscription is not past due, canceled, or incomplete.
- The selected plan is available to your account.
- You are not selecting your current plan.
If you have an outstanding balance, select Manage Billing, resolve it in Stripe, then return to DripDrop and try again.
Manage Billing is missing
The Manage Billing option becomes available after billing has been set up for the account. Only the account owner can manage the subscription.
My upgrade requires a payment method
Add a payment method when prompted, or select Manage Billing to update your default payment method. Then return to Dashboard → Settings → Billing, select Change Plan, and try the upgrade again.
My downgrade hasn’t happened yet
Downgrades take effect at the end of the current billing period. You can continue using your existing plan until the effective date displayed on the Billing page.
I want to cancel a scheduled downgrade
Select Keep current plan before the scheduled effective date.
Checkout doesn’t open correctly
Return to Dashboard → Settings → Billing and select the plan again. If checkout still doesn’t open, refresh the page and retry.
My usage is close to a limit
Review the usage amount and reset time. You can reduce usage, wait for the period to reset, or upgrade to a plan with higher limits.
My billing information looks outdated
Refresh the Billing page. If the information remains outdated, open Manage Billing to confirm the subscription status in Stripe, then return to DripDrop.
Billing information doesn’t load
Refresh the page and try again. If the problem continues, contact support and include any error message displayed.
Settings
A settings panel does not load
Refresh the page and try again. If the issue continues, check whether the problem is isolated to one tab or affects the whole settings area.
Timezone or toggles do not seem to save
Reopen the tab and confirm the updated value persisted. For Account timezone, make sure you chose a timezone from the dropdown and clicked Save.
Security or MFA changes feel risky
Be careful before removing the last working authentication method or trusted device. Generate backup codes after MFA is enabled and store them somewhere safe.
An API key was lost after creation
If the raw key is no longer visible, create a new key and revoke the old one instead of expecting Drip Drop to reveal the old secret again.
Settings / API Keys and Public API
An API request fails
- The key was copied correctly.
- The key has not expired.
- The key was not revoked.
- The account is active.
- The account subscription is active.
- The request uses the
X-API-Keyheader. - The request is sent to
https://api.dripdrop.dev. - The endpoint, method, and payload match the live API docs.
Admin
Admin is missing from the sidebar
- Confirm you are signed in to the correct account.
- The current dashboard UI only adds Admin navigation for the account owner.
- Ask the account owner or support to confirm your expected access.
Admin redirects somewhere unexpected
- Opening /dashboard/admin should redirect to /dashboard/admin/integrations.
- If the redirect fails, try a direct child route such as /dashboard/admin/custom-fields.
Integrations does not load
- Use Try Again if the page shows Error loading integrations.
- Confirm the account is selected and reload the dashboard if provider data does not appear.
A provider is missing or has an error
- Check Admin > Integrations first, then open the provider-specific setup docs for that service.
- Review Status, Last Verified, Inbound Status, and any provider-specific form fields.
A custom field cannot be deleted
If the field is in use, archive it instead. Archived fields stop appearing on new records while preserving existing values.
A Single Choice field will not save
Single Choice fields require at least one non-empty choice.
Tag creation or editing fails
- Confirm the tag has a name.
- Check that the color value is a valid hex color.
Audit Log looks empty or incomplete
- Clear search text and filters.
- Check pagination.
- Show hidden columns if you need User or IP Address.
Times look confusing
Compare timestamps with the timezone configured for the account in Settings.
Admin / Compliance
A contact did not receive a message
Check:
- Whether the contact unsubscribed, replied STOP, bounced, or triggered a spam complaint.
- Whether suppression is account-wide or per integration.
- Whether enrollment handling removed the contact from active flows.
- Whether the flow is trying to send through an inactive provider, sender, or template.
A provider is missing in the flow editor
Only active providers and active templates are available when configuring flow blocks. Some providers also require sender setup before they can be used.
Check:
- Provider status
- Template status
- Sender or from-address setup
- Whether the provider supports the required channel
An unsubscribed contact is still enrolled
If enrollment handling is set to suppress future sends only, the contact may remain enrolled but future suppressed sends are blocked. Use Flow Enrollments or Flow History to confirm what happened.
Flows
No flows visible
Confirm you are on Dashboard → Flows, clear search/filter controls, and check whether the flow is archived or complete.
Preview looks incomplete
Save the editor and confirm blocks and connections are present. The preview depends on saved flow structure.
Cannot launch or enroll confidently
Open the Flow Editor, save, and resolve any visible errors before changing status or adding more contacts.
Contacts missing from enrollment
Check filters and whether contacts are already enrolled in the flow.
History or stats look empty
Confirm at least one contact has entered the flow and enough time has passed for events to be recorded.
Flows / Flow Editor
Editor Will Not Load
Refresh the page and select Try Again from the flow load error state.
A Provider or Template Is Missing
Only active providers and templates are available in message-based blocks. Confirm the provider and template are active in Integrations then return to the editor.
An AI Block Is Unavailable
AI blocks require an active AI integration and the account’s AI features to be enabled. Confirm the AI provider is active before adding or configuring the block.
A Block Is Marked Incomplete
Open the block and complete its required configuration. Template-created flows can show warnings when providers, senders, recipients, templates, or custom fields were skipped during setup.
Cannot Connect Two Blocks
Check whether you are trying to create an invalid connection, such as Pause → Pause or Email → Email.
Errors Remain After Saving
Open the block named in the validation panel, correct the required fields, and save again. Review warnings before activating the flow.
Flows / Flow Blocks
A Provider or Template Is Missing
Only active providers and templates are available in message-based blocks. Activate the required record in Integrations or Templates, then reopen the block.
Related Documents: Integrations, Templates
A Notify Recipient Did Not Receive a Message
Confirm the recipient address or phone number is valid and the selected provider, sender, and template are active. Review History and Events for the delivery result.
Related Documents: History and Events
A Conditional Block Has No Source Block
A source block is required only for message-event rules. For contact data, enrollment data, tag, reachability, or consent rules, configure the relevant rule type instead.
A Pause Runs at an Unexpected Time
Check the flow timezone in Flow Settings. Time-based Pause blocks use the flow timezone, or the account timezone when no override is set.
Related Documents: Flow Settings
An A/B Split Will Not Save
Confirm that variant percentages total exactly 100%.
A Connection Block Is Failing
Review the target flow or webhook URL, authentication, headers, timeout, and fail-on-error setting.
A Block Still Appears Invalid
Save the flow, open the Errors panel, and complete the fields named in the current validation message.
Flows / Flow Settings
Save fails immediately
Check for a missing Name or any surfaced server-side validation messages.
Paused vs Active confusion
Use the full settings form if the card toggle is not enough.
Time-based behavior looks wrong
Confirm whether the flow is using the account default timezone or a flow-specific override.
Background, autosave, or snap changes do not seem visible
Reopen the editor after saving and verify you are looking at the same flow.
Custom fields missing
Those fields only appear when your account has flow custom fields configured.
Flows / Flow Enrollments
No contacts available
Either the account has no contacts yet or all eligible contacts are already enrolled.
Search returns nothing
Clear the search box or check spelling.
Contact has no usable channel
The edit or create form requires at least an email address or phone number.
Enroll button disabled
Select at least one contact first.
A record seems missing from the table
Clear search, status filters, or sort changes.
Enrollment stuck in Error or Processing
Inspect the flow configuration and the related flow history for the next clue.
Flows / History and Events
No rows yet
The flow may not have processed any contacts yet.
Expected row missing
Clear search and filters, then check that you are looking at the correct flow.
Interaction details missing
Not every event produces interaction records, and some rows are not expandable.
Too many rows to scan manually
Filter by Status or Type first, then search for the contact or step name.
Compare execution with enrollment state
Cross-check the contact in Flow enrollments.
Confirm whether a block actually ran
Find the matching Step in History.
Find who hit an error
Filter Status to Error and inspect the Contact column.
Confirm whether a pause or connection handoff happened
Filter Type to Pause or Connection.
Need to understand email or SMS engagement?
Expand the row and review interaction events.
A contact shows an error but the cause is unclear
Inspect the related block configuration in Flow blocks or the specific flow setup in the editor.
Flows / Stats and Reporting
Numbers look too low or zero
Check the selected flow and date range first.
Messages chart is empty
The selected period may contain no sends yet.
Opens chart is empty
Open tracking data may not exist yet for the current selection.
Delivery or bounce totals differ from expectations
Use History and events to inspect the underlying execution records.
Need to verify whether a specific contact caused the issue:
Stats is not the right tool; switch to Flow History or Flow Enrollments.
History
No rows yet
The flow may not have processed any contacts yet.
Expected row missing
Clear search and filters, then check that you are looking at the correct flow.
Interaction details missing
Not every event produces interaction records, and some rows are not expandable.
Too many rows to scan manually
Filter by Status or Type first, then search for the contact or step name.
Compare execution with enrollment state
Cross-check the contact in Flow enrollments.
Confirm whether a block actually ran
Find the matching Step in History.
Find who hit an error
Filter Status to Error and inspect the Contact column.
Confirm whether a pause or connection handoff happened
Filter Type to Pause or Connection.
Need to understand email or SMS engagement?
Expand the row and review interaction events.
A contact shows an error but the cause is unclear
Inspect the related block configuration in Flow blocks or the specific flow setup in the editor.
Unsubscribe and Public Pages
A Contact Remains Enrolled but Did Not Receive a Message
A contact can remain enrolled in a flow after unsubscribing or receiving a hard-bounce suppression. DripDrop checks suppression when it is about to send, so later messages for the suppressed channel are not sent.
Review the contact in Contacts, then review its flow status in Flow Enrollments.
A Contact Appears to Be Suppressed Unexpectedly
Check the recipient’s email address or phone number for an earlier unsubscribe, hard bounce, or SMS opt-out. Email matching is case-insensitive.
For the account’s opt-out scope and enrollment-handling rules, see Admin Compliance.
Preview Banner Missing
Confirm you are viewing the preview rendering rather than the normal public confirmation page.
Unsubscribe Link Preview Looks Wrong
Check whether the tracking domain is configured. Preview URL generation changes when a tracking domain is available.
You Expected a Preference Center
The current product behavior is a single unsubscribe confirmation page. Use Admin Compliance for account-level consent and suppression settings.