Event: Outreach failed

Fired when an automated outbound follow-up or recontact attempt cannot reach a lead. Examples include missing contact data, an opt-out, an invalid number, an unavailable channel, or an unknown delivery outcome. Use this event to route the lead for manual review. This event also surfaces an Instagram recontact that cannot be sent because the reply window is closed.

Payload

{
  "event_type": "outreach.failed",
  "event_id": "...",
  "webhook_id": "...",
  "delivery_id": "...",
  "timestamp": "2026-04-17T16:30:00.000Z",
  "client_id": "...",
  "test": false,
  "data": {
    "outreach": {
      "channel": "whatsapp",
      "reason": "invalid_number",
      "detail": "INVALID_PHONE:too_short",
      "source": "futurology_tasks",
      "failed_at": "2026-04-17T16:30:00.000Z"
    },
    "lead": {
      "id": "uuid",
      "first_name": "Tony",
      "last_name": "Stark",
      "email": null,
      "phone": null,
      "company": "Stark Industries",
      "source": "api",
      "external_id": null,
      "metadata": {}
    },
    "workflow": {
      "id": "uuid",
      "name": "Lead to purchase intent"
    }
  }
}

Fields

`data.outreach`

Field	Type	Description
`channel`	string \| null	Channel recorded for the attempt, such as `whatsapp`, `instagram`, `email`, `call`, or `sms`
`reason`	string	Why the attempt failed. See Reasons.
`detail`	string \| null	Diagnostic detail when recorded. It is `null` for the generic `delivery_failed` fallback.
`source`	string	Where the failure was detected: `futurology_tasks` or `recontact_log`
`failed_at`	string (ISO 8601)	When the attempt failed

Reasons

`reason`	Meaning
`missing_contact_data`	The lead had no contact value for the selected channel
`opt_out`	The lead opted out or is marked as not contactable
`invalid_number`	The phone number was rejected as invalid or undeliverable
`channel_down`	The channel could not send, such as an account problem or a closed Instagram reply window
`unreachable`	Nexor marked the lead as unreachable on that channel
`ambiguous_delivery`	The provider request may have succeeded, but Nexor could not confirm the outcome and suppressed an automatic resend
`delivery_failed`	Generic fallback for an uncategorized failure. `detail` is `null`.

`data.lead`

Field	Type	Description
`id`	string (uuid)	Lead ID
`first_name`	string \| null	Lead’s first name
`last_name`	string \| null	Lead’s last name
`email`	string \| null	Lead’s email
`phone`	string \| null	Lead’s phone
`company`	string \| null	Lead’s company
`source`	string	Source stored for the lead
`external_id`	string \| null	ID from an external system
`metadata`	object	Lead metadata

`data.workflow`

The workflow value can be null if the failed task has no associated workflow.

Field	Type	Description
`id`	string (uuid)	Workflow ID
`name`	string	Workflow name

Filtering

Use the Agent selector in the dashboard to receive this event for every agent or only one agent.

Last modified on September 8, 2026

Start here

Quickstart

API reference

Build and launch

WhatsApp

Channels

Agents

Meetings

Integrations

Account

Inbox

Insights

Developer tools

Support reference

Event: Outreach failed

Payload

Fields

`data.outreach`

Reasons

`data.lead`

`data.workflow`

Filtering

​Payload

​Fields

​data.outreach

​Reasons

​data.lead

​data.workflow

​Filtering

Payload

Fields

`data.outreach`

Reasons

`data.lead`

`data.workflow`

Filtering