Notifications and failure alerts

Looking for help with a specific error message? Check the Troubleshooting section instead. This article covers Coupler.io's built-in failure notifications, not individual error types.

When Coupler.io sends a notification

A single failed run doesn't trigger an email. Coupler.io retries automatically first, since some failures are a direct slow response from the source, or a brief connection issue. These type of issues tend to be resolve on their own.

Only when a scheduled data flow fails 5 times in a row does Coupler.io:

• Stop retrying
• Turn off the data flow's automatic schedule
• Send an email notification

Until you turn the schedule back on, the data flow won't run automatically, even after the original problem is fixed.

How the retry sequence works

Each failed run triggers an automatic retry, with longer waits between each attempt:

Consecutive failed attempt	What happens
1st	Retries after 15 minutes
2nd	Retries after 15 minutes
3rd	Retries after 30 minutes
4th	Retries after 1 hour
5th	No further retry. The automatic schedule turns off and you receive an email.

How retries interact with your regular schedule

If your next scheduled run is due before a retry would happen, Coupler.io runs the data flow at its regular scheduled time instead of waiting for the retry.

Example:

• Schedule: every hour
• Last failed attempt: 3:35 PM
• Retry would normally happen: 4:15 PM
• Next scheduled run: 4:00 PM

Since 4:00 PM comes first, Coupler.io runs the data flow then, rather than waiting until 4:15 PM.

Who receives the notification

The email goes to the mailbox of the user that owns the data flow. Currently, there's currently no way to add teammates or other recipients, even within a shared workspace.

What to do after you get the notification

1. Check the run history for the data flow to see the specific error.
2. Fix the underlying issue, based on what the error tells you.
3. Turn the automatic run schedule back on from the data flow's settings. Coupler.io won't re-enable it automatically, even once the problem is fixed.

What's not available yet

Coupler.io doesn't currently support:

• Notification rules you configure yourself
• Custom failure thresholds
• Configurable notification frequency
• Configurable notification recipients
• Sending the failure email to more than one person

Using webhooks for more flexibility

If you want other systems to react automatically to Coupler.io activity - for example, posting to a Slack channel - outgoing webhooks are available on higher-tier plans. You can add up to 3 outgoing webhooks per data flow from its settings; each one notifies an external service when a run completes.

Outgoing webhooks aren't a replacement for the failure notification above. They're a general-purpose way to connect Coupler.io to your own tools, not a configurable alerting system. To learn more about webhooks and how to configue please check our documentation: Webhooks Support

---

If you need further support, contact our team, and we'll help you review all your settings and notifications.