Calculate Risk Score
clearbit.calculate_risk
ActionCRM & salesconnection required
Calls the Clearbit API with the connection's credentials.
Score how likely a signup is fraudulent from its email address and IP, and return the reasons behind the score.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Clearbit
- Secret shape
- the secret API key (sk_…), or {"api_key": "…"}
- Config it needs
- stream, suppression, webhook_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
7 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
email The email address to score. | string | Yes | — | email format | — |
ip The IP address the signup came from. | string | Yes | — | — | — |
country_code The person's two-letter country code; strongly recommended. | string | No | — | — | — |
zip_code The person's postal or ZIP code; strongly recommended. | string | No | — | — | — |
given_name The person's first name; strongly recommended. | string | No | — | — | — |
family_name The person's last name; strongly recommended. | string | No | — | — | — |
name Full name, as an alternative to first and last name. | string | No | — | — | — |
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
level The risk level Clearbit assigned: low, medium or high. | string | — |
score The risk score out of 100. | number | — |
reasons Why Clearbit scored the signup that way. | array | — |
live False when the IP was a loopback test address. | boolean | — |
detail The full email, address and IP signal breakdown. | object | — |
{
"detail": {},
"level": "",
"live": false,
"reasons": [],
"score": 0
}Notes
- Both an email address and an IP address are required; the name, country and ZIP hints are optional but sharpen the score.
Solutions with Clearbit
See Calculate Risk Score run in a workflow.
In a technical demo we add the Clearbit connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.