Error handling
Types of errors
8 min
a {{scenario singular lowercase}} is composed of multiple modules and item mappings working together each element has the potential to trigger an unexpected event, called an error how errors are categorized {{product name}} classifies errors based on two primary factors, their origin and their underlying cause example a connectionerror typically occurs when a third party service is down for maintenance in this case, the origin is the external server, and the cause is the inability to establish a connection when a module returns an error, {{product name}} highlights it with a caution icon to view the error type, click the caution icon displayed above the module {{product name}} adheres to industry standard error codes and definitions however, it may be possible that the third party may not fully comply with these standards types of errors in {{product name}} accountvalidationerror type of error accountvalidationerror description a module outputs the accountvalidationerror when {{product name}} cannot authenticate you in the third party app for example, when you change your credentials in the app or your credentials expire and you don't update them in the connection, the app module will output the accountvalidationerror the accountvalidationerror also appears also with the https //en wikipedia org/wiki/list of http status codes if a module outputs the accountvalidationerror , the {{scenario singular lowercase}} ends with an error when your {{scenario singular lowercase}} finishes with an error for the docid 7 hehdtuu2xyys8 qurub in a row, {{product name}} disables the scheduling of your {{scenario singular lowercase}} it is not possible to handle the accountvalidationerror with an error handler, because the error happens during the intialization of the scenario solution to fix the accountvalidationerror , review your credentials in the app and the connection in {{product name}} if necessary, create a new connection for the app if you are getting the accountvalidationerror frequently, contact our https //www make com/en/ticket bundlevalidationerror type of error bundlevalidationerror description a module outputs the bundlevalidationerror when the bundle that enters the module doesn't pass validation validation means that before processing a bundle in a module, {{product name}} checks whether data types match in the module mappings and whether there are no missing values in the module required fields the bundlevalidationerror appears also with the https //en wikipedia org/wiki/list of http status codes for example, you get the bundlevalidationerror when you map text to a module settings field that requires a date, or when you map an empty value to a required field in the module settings if a module outputs the bundlevalidationerror with no error handling, the {{scenario singular lowercase}} ends with an error when your {{scenario singular lowercase}} finishes with an error for the docid 7 hehdtuu2xyys8 qurub in a row, {{product name}} disables the scheduling of your {{scenario singular lowercase}} solution the best way to handle this error is to review your mapping in the module settings for tips on how to handle missing data in a {{scenario singular lowercase}} check out the article about docid\ ei26zlhgxbmjk7woiqfw connectionerror type of error connectionerror description a module outputs the connectionerror when the third party app is unavailable for example, the third party service might be offline because of maintenance this error uses the https //en wikipedia org/wiki/list of http status codes the default handling of the connectionerror depends on the following attributes scheduled {{scenario singular lowercase}} with i ncomplete executions disabled {{product name}} pauses the scheduling of the scenario for 20 minutes {{product name}} doesn't rerun the scenario scheduled {{scenario singular lowercase}} with i ncomplete executions enabled {{product name}} pauses the scheduling of the scenario for 20 minutes {{product name}} retries the incomplete execution with the incomplete execution docid\ le2snkujgl9uzqfm 0v3i instant {{scenario singular lowercase}} with i ncomplete executions disabled {{product name}} reruns the incomplete execution with the {{scenario singular lowercase}} docid\ le2snkujgl9uzqfm 0v3i instant {{scenario singular lowercase}} with i ncomplete executions enabled {{product name}} retries the incomplete execution with the incomplete execution docid\ le2snkujgl9uzqfm 0v3i solution to fix the connectionerror , see the docid\ bbfjxepacbq4bweghxszy page dataerror type of error dataerror description a module outputs the dataerror when data sent by the module doesn't pass validation on the third party side for example, when you try to create a tweet with the twitter > create a tweet module that has more than 280 characters, the create a tweet module outputs the dataerror because tweets have a maximum length of 280 characters another situation when you get the dataerror is when you map an incorrect data type to a function for example, when you map data with the text data type to the date and time functions docid 1kv1ib5q50i0slbc7g2pz function if a module outputs the dataerror with no error handling, the {{scenario singular lowercase}} ends with an error when your {{scenario singular lowercase}} finishes with an error for the docid 7 hehdtuu2xyys8 qurub in a row, {{product name}} disables the scheduling of your {{scenario singular lowercase}} to fix the dataerror , review your mapping and identify the reason why the error happens if you cannot fix the error with different mapping, you can use the docid\ wr8aaeme2ptfar38vxd3p and docid\ xzfc2uhei4kmsmhydbnmp error handlers solution to fix the dataerror , review your mapping and identify the reason why the error happens if you cannot fix the error with different mapping, you can use the docid\ wr8aaeme2ptfar38vxd3p and docid\ xzfc2uhei4kmsmhydbnmp error handlers datasizelimitexceedederror type of error datasizelimitexceedederror description a module outputs the datasizelimitexceedederror when you run out of data transfer quota your data transfer limit is calculated from the credits limit if a module outputs the datasizelimitexceedederror with no error handling, the {{scenario singular lowercase}} ends with an error because the datasizelimitexceedederror is a fatal error, {{product name}} immediately disables the {{scenario singular lowercase}} scheduling, regardless of the docid 7 hehdtuu2xyys8 qurub solution to fix the datasizelimitexceedederror , consider buying docid 2zcwidbk uamtp2x2 7kj or upgrading your organization's subscription plan duplicatedataerror type of error duplicatedataerror description a module outputs the duplicatedataerror when you send the same data to a module that doesn't allow duplicates for example, when you try to create a new user in an app and the user's e mail address has to be unique, but the e mail address is used already the module outputs the duplicatedataerror , because the e mail address is registered with another user already if a module outputs the duplicatedataerror with no error handling, the {{scenario singular lowercase}} ends with an error when your {{scenario singular lowercase}} finishes with an error for the docid 7 hehdtuu2xyys8 qurub in a row, {{product name}} disables the scheduling of your {{scenario singular lowercase}} solution if you get the duplicatedataerror in your {{scenario singular lowercase}} , you should review your {{scenario singular lowercase}} design for example, if you are using a database, you could first check if the database record exists with a search module or with the email example, you could just ignore the error with the docid\ xzfc2uhei4kmsmhydbnmp incompletedataerror type of error incompletedataerror description a module outputs the incompletedataerror when the module can get only part of the data from the third party app for example, when you are uploading new photos to google photos and you have a {{scenario singular lowercase}} that downloads the photos at the same time {{product name}} tries to download the photo that you are currently uploading the photo file won't be complete and the google photos module will output the incompletedataerror if a module outputs the incompletedataerror with no error handling, the {{scenario singular lowercase}} ends with an error {{product name}} pauses the scenario for 20 minutes and then runs the {{scenario singular lowercase}} again until the {{scenario singular lowercase}} succeeds or reaches the docid 7 hehdtuu2xyys8 qurub solution if you want to handle the incompletedataerror , you can use the docid\ hxe6n1fool691glswodgy inconsistencyerror type of error inconsistencyerror description a module outputs the inconsistencyerror when an error happens during the {{scenario singular lowercase}} rollback this error can occur when you make changes to a data store with two {{scenario plural lowercase}} that run at the same time if one {{scenario singular lowercase}} encounters an error and attempts to undo the changes in the rollback phase, but the other {{scenario singular lowercase}} already finished making changes, the changes cannot be safely undone and you get the inconsistencyerror from the data store module in the first {{scenario singular lowercase}} for example, imagine two people making changes in the same part of a file one of them saves changes before the other what happens with the changes from the other person? if a module outputs the inconsistencyerror with no error handling, the {{scenario singular lowercase}} ends with an error because the inconsistencyerror is a fatal error, {{product name}} immediately disables the {{scenario singular lowercase}} scheduling, regardless of the docid 7 hehdtuu2xyys8 qurub solution to fix the inconsistencyerror , check your data and fix the data if necessary if you are getting the inconsistencyerror frequently, check the {{scenario plural lowercase}} that use the database maxfilesizeexceedederror type of error maxfilesizeexceedederror description a module outputs the maxfilesizeexceedederror when you try to process a file that exceeds the maximum file size the maximum file size differs based on your organization's subscription you can check the maximum file sizes in the {{product name}} https //www make com/en/pricing for example, if you use the google drive > move a file module in an organization with the core plan to move a file larger than 100 mb, you would get the maxfilesizeexceedederror if a module outputs the maxfilesizeexceedederror with no error handling, the {{scenario singular lowercase}} ends with an error when your {{scenario singular lowercase}} finishes with an error for the docid 7 hehdtuu2xyys8 qurub in a row, {{product name}} disables the scheduling of your {{scenario singular lowercase}} solution to fix the maxfilesizeerror , you have to either make the file smaller (compress or split the file) or upgrade your organization's subscription plan moduletimeouterror type of error moduletimeouterror description this error occurs due to a module timeout when a request sent by a {{product name}} module does not receive a response within the expected timeframe if the endpoint does not return any data, the module waits for a response for up to 40 seconds (most {{product name}} modules have a runtime limit of 40 or 60 seconds) when this limit is exceeded, make returns a moduletimeouterror the operation timed out error this issue typically occurs when the external server delays its response because of temporary service issues or server overload solution to fix this issue and prevent the scenario from failing, configure a break error handler and enable the storage of incomplete executions when configured, the break directive automatically retries the same action up to three times, with delays of 5, 10, and 15 minutes if the error persists after all retry attempts, the execution is stored under the incomplete executions tab, where it can be reviewed and resolved manually if incomplete execution storage is enabled without adding a break error handler, failed runs are still stored under the incomplete executions tab however, no automatic retry attempts will be made, and the executions must be resolved manually detailed setup instructions are available in the resources linked below docid\ hxe6n1fool691glswodgy docid 6zznn7v35herrcjfccp9q example airtable timeout error an error occurs when the airtable server doesn't respond within make's timeout window it's typically caused by a temporary delay on airtable's end rather than an issue with your scenario configuration make waits 40 seconds for a response (airtable has an extended timeout of up to 80 seconds), but when the external server is slow to respond, the request times out to fix this add a break error handler to your airtable module this will automatically retry your operation 3 times at 5, 10, and 15 minutes after the initial timeout enable store incomplete executions so if all retries fail, the execution is stored for manual resolution instead of being lost by doing so, temporary delays on airtable's end won't cause your scenario to fail permanently, it will retry automatically and recover most of the time if timeouts continue you can also review your look for changes settings to see if narrowing the search criteria or reducing the number of records processed helps operationslimitexceedederror type of error operationslimitexceedederror description a module outputs the operationslimitexceedederror when you run out of credits your credit limit is set with your organization's subscription you can check your credit limit in https //www make com/en/pricing if a module outputs the operationslimitexceedederror , the {{scenario singular lowercase}} ends with an error because the operationslimitexceedederror is a fatal error, {{product name}} immediately disables the {{scenario singular lowercase}} scheduling, regardless of the docid 7 hehdtuu2xyys8 qurub solution to fix the operationslimitexceedederror , consider buying docid 2zcwidbk uamtp2x2 7kj or upgrading your organization's subscription plan ratelimiterror type of error ratelimiterror description a module outputs the ratelimiterror when you make too many requests over a time period to the app api this error uses the https //en wikipedia org/wiki/list of http status codes and follows the https //en wikipedia org/wiki/rate limiting rules of the third party for example, the docid\ g7vz7fysaoicjddxzcncz modules output the ratelimiterror when you reach the number of api calls per minute based on your https //www make com/en/pricing the default handling of the ratelimiterror depends on the following attributes scheduled {{scenario singular lowercase}} with i ncomplete executions disabled {{product name}} pauses the scheduling of the scenario for 20 minutes {{product name}} doesn't rerun the scenario scheduled {{scenario singular lowercase}} with i ncomplete executions enabled {{product name}} pauses the scheduling of the scenario for 20 minutes {{product name}} retries the incomplete execution with the incomplete execution docid\ le2snkujgl9uzqfm 0v3i instant {{scenario singular lowercase}} with i ncomplete executions disabled {{product name}} reruns the incomplete execution with the {{scenario singular lowercase}} docid\ le2snkujgl9uzqfm 0v3i instant {{scenario singular lowercase}} with i ncomplete executions enabled {{product name}} retries the incomplete execution with the incomplete execution docid\ le2snkujgl9uzqfm 0v3i solution to fix the ratelimiterror , see the docid\ oxgtalgvur0yzkn ux9wk page runtimeerror type of error runtimeerror description a module outputs the runtimeerror when the error reported by the third party app doesn't meet the criteria for any other error type for example, you get the runtimeerror when you use up all your tokens with the openai > create a completion module if a module outputs the runtimeerror with no error handling, the {{scenario singular lowercase}} ends with an error when your {{scenario singular lowercase}} finishes with an error for the docid 7 hehdtuu2xyys8 qurub in a row, {{product name}} disables the scheduling of your {{scenario singular lowercase}} solution there's no general rule to fixing the runtimeerror check the error message in the {{scenario singular lowercase}} history or try to reproduce the error with the docid\ bchjzzddem 1pyfex4npc the docid 7 hehdtuu2xyys8 qurub topic can help you create your error handling strategy