Handling Actions Based on Enrichment Errors: Best Practices

Mathew I. · 2025-08-21 14:58:06.681621+00

Whats the best way to take different actions based on an enrichment error? For example, I want to do X if the "profile was not found" and Y if there way an error running the enrichment

Handling Actions Based on Enrichment Errors: Best Practices | Clay

14 comments

· Sorted by Oldest

Clay
APP
·
·
Use conditional runs in the Run Settings of your enrichment columns to handle different error scenarios. Go to Run Settings → "Only run if" box and add conditional formulas that check for specific error conditions. You can use the "Use AI" button to input plain language instructions like "only run if profile was not found" or "only run if previous enrichment failed." This allows you to create if/then logic where specific actions only trigger when certain conditions aren't met, similar to waterfall logic.
Sources: Guide: Ways to save Clay credits | Documentation | Clay University Best Practices To Maximize Your Credits - Clay University Clay enrichments integration overview | Documentation | Clay University
Mathew I.
·
·
Yes but how do I access the error? I don't think this is possible?
Clay
APP
·
·
You can reference enrichment data from other columns, including accessing entire enrichments and their properties. However, the available documentation focuses on resolving enrichment errors rather than accessing error details programmatically. Common enrichment errors include "missing input," "no valid company identifiers," and issues with invalid domains or missing website URLs. These typically occur when critical input data is missing or invalid. Are you looking to create conditional logic based on whether an enrichment succeeded or failed, or do you need to access specific error messages returned by enrichments?
Source: Referencing dynamic data from other columns | Documentation | Clay University
Mathew I.
·
·
Ask a person
Mathew I.
·
·
Yes
Gabe E.
·
·
Mathew - Do you mind sending the link (url) to the table so we can take a look?
(52 kB)
Mathew I.
·
·
https://app.clay.com/workspaces/423342/workbooks/wb_0t1bu94MtoK9se75CeZ/tables/t_0t1bu9ivV3FJTDejE3M/views/gv_0t1bu9iq4w6ifkZHzfB I am trying to enrich data in my CRM and want to:
Initiate a retry if the enrichment fails
Mark it as failed if "no profile found"
How do I differentiate between these 2 in the run settings?
Gabe E.
·
·
Which enrichment are you looking to retry? Are you editing these in a certain columns run settings? If an enrichment is "no profile found" that means that data doesn't exist with our providers. I'm worried retrying that won't get you the solution you want.
Gabe E.
·
·
To address above, You could use formulas for: ** If "no profile found," serve 1 ** If successful response, serve 2 * if anything else, serve 3 You could set the run condition to re-run for all those with 3, hypothetically. But again, I'm still concerned this won't get you towards your overall goal.
Mathew I.
·
·
No the whole point is I DO NOT want to retry when "no profile found" -- but I DO want to retry if there was a general processing error What would the formula look like for "If no profile found"? And how would it be different than "If error"? Do you see what I'm asking?
Gabe E.
·
·
The error message likely wouldn't be read correctly. If we are seeing errors at that scale I'd want to try and fix those rows to get the flow working . Are you seeing any particular problem rows I can look into? If you highlight them I'm happy to take a closer look!
Gabe
Mathew I.
·
·
Sorry don't think I understand
Mathew I.
·
·
I am asking how to differentiate "no profile found" from "processing error" in a formula
Gabe E.
·
·
Hi Mathew, got it, I'm worried about the formula's ability to differentiate these. We likely aren't able to set a table to re-run only errored outputs at this time.

Loading comments

Clay
APP
·
·
Use conditional runs in the Run Settings of your enrichment columns to handle different error scenarios. Go to Run Settings → "Only run if" box and add conditional formulas that check for specific error conditions. You can use the "Use AI" button to input plain language instructions like "only run if profile was not found" or "only run if previous enrichment failed." This allows you to create if/then logic where specific actions only trigger when certain conditions aren't met, similar to waterfall logic.
Sources: Guide: Ways to save Clay credits | Documentation | Clay University Best Practices To Maximize Your Credits - Clay University Clay enrichments integration overview | Documentation | Clay University
Mathew I.
·
·
Yes but how do I access the error? I don't think this is possible?
Clay
APP
·
·
You can reference enrichment data from other columns, including accessing entire enrichments and their properties. However, the available documentation focuses on resolving enrichment errors rather than accessing error details programmatically. Common enrichment errors include "missing input," "no valid company identifiers," and issues with invalid domains or missing website URLs. These typically occur when critical input data is missing or invalid. Are you looking to create conditional logic based on whether an enrichment succeeded or failed, or do you need to access specific error messages returned by enrichments?
Source: Referencing dynamic data from other columns | Documentation | Clay University
Mathew I.
·
·
Ask a person
Mathew I.
·
·
Yes
Gabe E.
·
·
Mathew - Do you mind sending the link (url) to the table so we can take a look?
(52 kB)
Mathew I.
·
·
https://app.clay.com/workspaces/423342/workbooks/wb_0t1bu94MtoK9se75CeZ/tables/t_0t1bu9ivV3FJTDejE3M/views/gv_0t1bu9iq4w6ifkZHzfB I am trying to enrich data in my CRM and want to:
Initiate a retry if the enrichment fails
Mark it as failed if "no profile found"
How do I differentiate between these 2 in the run settings?
Gabe E.
·
·
Which enrichment are you looking to retry? Are you editing these in a certain columns run settings? If an enrichment is "no profile found" that means that data doesn't exist with our providers. I'm worried retrying that won't get you the solution you want.
Gabe E.
·
·
To address above, You could use formulas for: ** If "no profile found," serve 1 ** If successful response, serve 2 * if anything else, serve 3 You could set the run condition to re-run for all those with 3, hypothetically. But again, I'm still concerned this won't get you towards your overall goal.
Mathew I.
·
·
No the whole point is I DO NOT want to retry when "no profile found" -- but I DO want to retry if there was a general processing error What would the formula look like for "If no profile found"? And how would it be different than "If error"? Do you see what I'm asking?
Gabe E.
·
·
The error message likely wouldn't be read correctly. If we are seeing errors at that scale I'd want to try and fix those rows to get the flow working . Are you seeing any particular problem rows I can look into? If you highlight them I'm happy to take a closer look!
Gabe
Mathew I.
·
·
Sorry don't think I understand
Mathew I.
·
·
I am asking how to differentiate "no profile found" from "processing error" in a formula
Gabe E.
·
·
Hi Mathew, got it, I'm worried about the formula's ability to differentiate these. We likely aren't able to set a table to re-run only errored outputs at this time.