SAsalesforge
Validations

Start validation run

Starts asynchronous email validation for the contacts the filters resolve to.

Before returning, submission resolves and persists exact lead IDs and emails after filters, exclusions, sequence scope, deduplication, and the effective limit. The exact selected count is checked against current credits; insufficient credits return 402 without creating a run. Non-empty runs return pending. Empty selections return a terminal failed run with failureCode validation_scope_empty. The deprecated strict field is accepted and ignored.

post/multichannel/workspaces/{workspaceID}/validations

Request

  • Base URL
    https://multichannel-api.salesforge.ai/public
  • Auth
    API key in header Authorization

Path parameters

workspaceIDstring required

Workspace ID

Request body

object required
OR

Response

Validation initiated

failureCode'validation_scope_empty' | 'insufficient_credits' | 'validation_execution_failed' | 'validation_timed_out' | 'validation_results_sync_failed' | 'credit_reservation_failed' | 'credit_reconciliation_failed' | 'validation_processing_failed'

FailureCode identifies a stable terminal failure reason.

matchedinteger

Matched counts contacts returned while resolving the submitted scope. Deprecated: use selected at submission and validation results after completion.

messagestring

Deprecated: inspect status and failureCode on validation results instead.

selectedinteger

Selected counts the exact candidates frozen for this run.

startedboolean

Deprecated: Started is retained as true for accepted asynchronous submissions.

status'pending' | 'failed'

Status is the lifecycle status at submission completion.

validationJobIDstring

Example response

{
  "status": "pending"
}

Changes

No recorded changes to this operation across all 1 revision of this API.