Required Input Fields: Validate, Find & Compare

Which inputs trigger Validate, Find, or Compare mode for each Delpha capability — required and support fields with examples, across Salesforce, API, and MCP.

Delpha runs the same dynamic engine across every channel — Salesforce, the API, and MCP agents. You never select a mode explicitly: the inputs you provide route each request automatically into Validate, Find, or Compare.

Input Classification

• Mandatory inputs: required to trigger the engine. Omitting a mandatory input rejects the request (over the API, this returns HTTP 400 Bad Request).

• Support inputs: contextual attributes (e.g., website, company name) that improve AI confidence scoring and match precision.

Execution Logic & Workflow Routing

For any supported data attribute (Email, Address, Phone, Legal ID, Website, LinkedIn, Ultimate Parent), Delpha routes execution into one of three distinct modes based on which inputs are present:

Execution Modes

• Mode 1: Validate (Syntax & Deliverability)

  • Trigger: Primary input provided; support inputs omitted or empty.

  • Behavior: Verifies syntax, structural integrity, domain status, and functional deliverability.

• Mode 2: Find & Recommend (Data Enrichment)

  • Trigger: Primary input empty; support inputs provided.

  • Behavior: Uses contextual attributes (e.g., Name + Website) to query internal and external data sources to discover the missing value.

• Mode 3: Compare & Measure Accuracy (Data Verification & Scoring)

  • Trigger: Both primary input and support inputs provided.

  • Behavior: Cross-verifies attribute alignment, detects personal vs. professional mismatches, and outputs an Accuracy Confidence Score alongside suggested corrections.

Field Matrix by Capability

The same inputs apply whether Delpha runs inside Salesforce, is called by an AI agent over MCP, or is invoked through the API.

Capability	Execution Mode	Mandatory Inputs	Support / Optional Inputs
Email	Validate	email	None
Email	Find	email: null, website, first_name, last_name	None
Email	Compare	email, website, first_name, last_name	None
Legal ID	Validate	legal_id, legal_id_type (or country)	None
Legal ID	Find	legal_id: null, company_name, legal_id_type (or country)	address, website
Legal ID	Compare	legal_id, company_name, legal_id_type (or country)	address, website
Address	Validate	street, postal_code, city, country, state	None
Address	Find	address: null, company_name, (website | legal_id | linkedin)	website, legal_id, linkedin
Address	Compare	address, company_name, (website | legal_id | linkedin)	website, legal_id, linkedin
Phone	Validate	phone	country
Website	Validate	website	None
Website	Find	website: null, company_name	legal_id, linkedin, email, country
Website	Compare	website, company_name	legal_id, linkedin, email, country
Name	Validate	first_name, last_name	None
LinkedIn	Validate	url	None
LinkedIn	Find	Account: url: null, company_name Contact: url: null, first_name, last_name	Account: country, website Contact: company_name, email
LinkedIn	Compare	Account: url, company_name Contact: url, first_name, last_name	Account: country, website Contact: company_name, email
Ultimate Parent	Find	company_name, website	country

Note on empty inputs: Leaving support inputs empty (or null) is valid. Delpha defaults to Validate Mode whenever support inputs are missing.

Calling the Engine via the API

Base URL: https://api.delpha.io/v1

Headers: Authorization: Bearer <YOUR_API_KEY> | Content-Type: application/json

Each capability maps to one endpoint — the mode is inferred from the payload, exactly as in the matrix above:

Capability	Endpoint
Email	POST /v1/email
Legal ID	POST /v1/legal_id
Address	POST /v1/address
Phone	POST /v1/phone
Website	POST /v1/website
Name	POST /v1/name
LinkedIn	POST /v1/linkedin
Ultimate Parent	POST /v1/ultimate-parent

JSON Payload Reference Examples

1. Check Validity Mode Payload

Endpoint: POST /v1/email

{
  "email": "[e-mail]",
  "first_name": null,
  "last_name": null,
  "website": null
}

• Triggered Behavior: Validates syntax and verifies inbox deliverability for [e-mail].

2. Find & Recommend Mode Payload

Endpoint: POST /v1/email

{
  "email": null,
  "first_name": "Samantha",
  "last_name": "Parker",
  "website": "https://cogicog.com"
}

• Triggered Behavior: Queries data sources to discover the missing professional email address for Samantha Parker at Cogicog.

3. Compare & Measure Accuracy Mode Payload

Endpoint: POST /v1/email

{
  "email": "[e-mail]",
  "first_name": "Samantha",
  "last_name": "Parker",
  "website": "https://cogicog.com"
}

• Triggered Behavior: Evaluates alignment between the personal address (gmail.com) and corporate domain (cogicog.com), returning a confidence score and suggesting [e-mail].