Skip to content

Tool

set_contact_lifecycle

Set a contact's lifecycle

Idempotent
SurfacesChat agentMCP

Set a contact's lifecycle stage: `prospect` (unverified), `active` (engaged), or `invalid` (bad/bounced). Identify by contactId or email. Auto-commits.

Parameters

NameTypeRequiredDescription
contactIdstringnoThe contact id (preferred).
emailstringnoThe contact's email (resolved if no contactId).
lifecycleprospectactiveinvalidyesThe new lifecycle stage.

Example

json
{
  "lifecycle": "prospect"
}