Outgoing Webhooks

Sixtyfour POSTs to your URL when work completes, so you react in real time instead of polling. Outgoing webhooks come from two sources that share one signed, retried delivery pipeline:

Source	Trigger	Payload
Async-job webhook	`webhook_url` in the body of an async endpoint	Job result envelope
Workflow `outgoing_webhook` block	The block in a workflow	Workflow run envelope with results

Headers, signing, retries and URL rules are the same for both sources. Only the payload differs.

Async-job webhooks

Pass an optional webhook_url in the request body. When the job completes, Sixtyfour POSTs the result to that URL.

Supported endpoints

Endpoint	Callback
`/find-email-async`, `/find-email-bulk-async`	Job result envelope
`/find-phone-async`, `/find-phone-bulk-async`	Job result envelope
`/reverse-email-async`, `/reverse-email-bulk-async`	Job result envelope
`/reverse-phone-async`, `/reverse-phone-bulk-async`	Job result envelope
`/people-intelligence-async`	Job result envelope
`/company-intelligence-async`	Job result envelope
`/qa-agent-async`	Job result envelope
`/bulk-intelligence/people`, `/bulk-intelligence/company`	Set `webhook_url` in the job config. See Bulk Intelligence.
`POST /monitors`, `POST /monitors/{monitor_id}/update`	Monitor events. See Monitor Notifications.

webhook_url must be an https:// URL. A plain http:// URL is rejected with 422.

Request

POST /find-email-async
{
  "lead": {
    "name": "Jane Smith",
    "company": "Northgate Labs",
    "linkedin_url": "https://linkedin.com/in/janesmith"
  },
  "webhook_url": "https://your-server.com/webhooks/sixtyfour"
}

The endpoint returns a task_id immediately:

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "RUNNING",
  "total_leads": 1,
  "mode": "PROFESSIONAL"
}

Payload

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "task_type": "find_email",
  "result": {
    "leads": [
      {
        "name": "Jane Smith",
        "company": "Northgate Labs",
        "email": [["jane.smith@northgatelabs.com", "OK", "COMPANY"]],
        "other_emails": []
      }
    ],
    "total_leads": 1,
    "emails_found": 1,
    "cost_cents": 5,
    "cost_credits": 0.5,
    "mode": "PROFESSIONAL"
  },
  "error": null,
  "event_id": "f7c2a4e0-9b5d-4a1f-8d2c-1e3b5f7a9c0d",
  "attempt": 1
}

Field	Type	Description
`task_id`	string	The job’s ID, as returned by the async endpoint.
`status`	string	`completed`.
`task_type`	string \| null	Job type. See the table below. Match callbacks to requests by `task_id`.
`result`	object	The job result, in the same shape as the `result` of `GET /job-status/{task_id}`.
`error`	null	Always null. Failures are reported through `/job-status/{task_id}`.
`event_id`	string (UUID)	Unique per delivery. Stays the same across retries of that delivery.
`attempt`	integer	Delivery attempt, starting at `1`.
`investigation`	object	People Intelligence `xhigh` only: `{ "id", "workspace_url" }` of the Atlas investigation the job created.

Result fields by endpoint

Endpoint family	`task_type`	`result` shape
Find Email	`find_email`	`leads`, `total_leads`, `emails_found`, `cost_cents`, `cost_credits`, `mode`
Find Phone	`find_phone`	`leads`, `total_leads`, `phones_found`, `cost_cents`, `cost_credits`
Reverse Email, Reverse Phone	`reverse_enrichment`	`leads`, `total_leads`, `successful_lookups`, `cost_cents`, `cost_credits`
People Intelligence	`lead_enrichment`	Same as the job-status `result`. `xhigh` jobs also carry the research notes, graph and workspace files.
Company Intelligence	`company_enrichment`	Same as the job-status `result`
QA Agent	`null`	Same as the job-status `result`

Find Email, Find Phone, Reverse Email and Reverse Phone wrap records in result.leads, including single-record requests. cost_credits is the amount charged for the job; cost_cents is the legacy field. The callback’s task_type matches the Sixtyfour-Event-Type header and the task_type that /job-status/{task_id} returns.

Job failures

Sixtyfour sends callbacks for completed jobs only. Failed, cancelled and timed-out jobs send no callback. Keep the task_id and poll GET /job-status/{task_id} if no callback arrives within your deadline.

Workflow `outgoing_webhook` block

Add an outgoing_webhook block to POST the run’s results to your URL. The block sends one request per run, not per row.

Block specs

Field	Type	Default	Description
`url`	string	required	Destination URL. `http://` or `https://`, public host only.
`headers`	object	none	Extra request headers. Names that are not valid HTTP header names are dropped; CR and LF are stripped from values.
`timeout_seconds`	float	`10`	Per-attempt timeout, `0 < x ≤ 300`. Values above 150 are capped at 150.
`include_csv_download_link`	boolean	`false`	Wait up to 120 seconds for the previous block’s results and include signed download URLs in the payload.

The block adds three columns to the workflow output: webhook_status_code, webhook_response (first 2,000 characters) and webhook_success.

Payload

{
  "event_id": "f7c2a4e0-9b5d-4a1f-8d2c-1e3b5f7a9c0d",
  "event": "outgoing_webhook.completed",
  "status": "success",
  "workflow_id": "wf_abc123",
  "run_id": "run_xyz789",
  "organization_id": "org_456",
  "row_count": 95,
  "previous_block_id": "blk_2",
  "previous_block_name": "lead_enrichment",
  "previous_block_number": 2,
  "completed_at": "2026-04-22T20:00:00Z",
  "duration_ms": 1234,
  "attempt": 1,
  "results_download_url": "https://...signed-csv-url...",
  "ndjson_download_url": null,
  "results": [
    { "name": "Jane Smith", "email": "jane.smith@northgatelabs.com" }
  ]
}

Field	Type	Description
`event_id`	string (UUID)	Unique per delivery, same across retries. Matches the `Sixtyfour-Event-Id` header.
`event`	string	Always `outgoing_webhook.completed`.
`status`	string	Always `success`.
`workflow_id`	string	The workflow definition ID.
`run_id`	string	The run ID.
`organization_id`	string	Your organization ID.
`row_count`	integer	Rows in the result, including rows that failed at an earlier step.
`previous_block_id`	string	ID of the block before the webhook block.
`previous_block_name`	string	Block type of the previous block, such as `lead_enrichment`.
`previous_block_number`	integer	Sequence number of the previous block.
`completed_at`	string (ISO 8601)	When this attempt was sent.
`duration_ms`	integer	Time spent in the webhook block.
`attempt`	integer	Delivery attempt, starting at `1`.
`results_download_url`	string \| null	Signed CSV download URL when `include_csv_download_link` is `true`. Expires after 15 minutes.
`ndjson_download_url`	string \| null	Signed NDJSON download URL when `include_csv_download_link` is `true` and the run requested NDJSON results. Expires after 15 minutes.
`results`	array \| null	Inline rows when the input is at most 200 rows and 512 KB; otherwise `null`. Rows are the ones entering the webhook block, without keys that start with `_`.

Failed rows in the payload

The block receives every row, including rows that failed at an earlier step. A failed row has Failed in the columns its failing step would have filled and no values from later steps. The payload has no per-row outcome field and an ordinary value can also be Failed, so neither that text nor row_count identifies failed rows. To identify failed rows, wait for the run to reach a terminal status and read the Status column of the final result. See Failed rows and Download results. A run where every row fails ends as failed, and its results can still be downloaded.

Delivery

Headers

Header	Value
`Content-Type`	`application/json`
`Sixtyfour-Signature`	`t=<unix_seconds>,v1=<hex>[,v1=<hex>]`
`Sixtyfour-Event-Id`	UUID per delivery, same across retries
`Sixtyfour-Event-Type`	`task_type` for async jobs, `outgoing_webhook.completed` for the block
`Sixtyfour-Delivery-Attempt`	Attempt counter starting at `1`

The Sixtyfour-* headers are sent only when your organization has a signing secret. Without one, deliveries are unsigned and carry no Sixtyfour-* headers.

Retries

Setting	Value
Attempts	5 (1 initial attempt and 4 retries)
Backoff	1s, 2s, 4s, 8s between attempts
Timeout	10 seconds per attempt for async jobs; `timeout_seconds` for the block
Success	Any `2xx` response
Redirects	Not followed. A `3xx` response counts as a failed attempt.

If every attempt fails, the delivery is dropped. The job or run itself is unaffected, and its results stay available by polling.

URL rules

Sixtyfour checks the destination before every attempt. URLs with credentials, localhost, *.local hosts, and hosts that resolve to private, loopback, link-local or other non-public IPs are rejected and not retried. A DNS lookup that fails counts as a failed attempt and is retried.

Receiver checklist

Return 2xx within the timeout and process the payload asynchronously.
Return 2xx for events you ignore. Any other status triggers retries.
Dedupe on event_id (or Sixtyfour-Event-Id).
Match deliveries to the task_id or run_id you started.
Once signing is enabled, reject deliveries without a valid Sixtyfour-Signature.

Polling fallback

Results stay available whether or not a webhook is delivered:

Async jobs: GET /job-status/{task_id}
Workflow runs: the status and download endpoints in Workflow Execution

Errors

For error responses (400, 403, etc.), see Handling Errors.

Get Started

Intelligence API

Search API

Workflows API

Monitors API

Webhooks

Troubleshooting

Developer Tools

Async-job webhooks

Supported endpoints

Request

Payload

Result fields by endpoint

Job failures

Workflow `outgoing_webhook` block

Block specs

Payload

Failed rows in the payload

Delivery

Headers

Retries

URL rules

Receiver checklist

Polling fallback

Errors

​Async-job webhooks

​Supported endpoints

​Request

​Payload

​Result fields by endpoint

​Job failures

​Workflow outgoing_webhook block

​Block specs

​Payload

​Failed rows in the payload

​Delivery

​Headers

​Retries

​URL rules

​Receiver checklist

​Polling fallback

​Errors

Async-job webhooks

Supported endpoints

Request

Payload

Result fields by endpoint

Job failures

Workflow `outgoing_webhook` block

Block specs

Payload

Failed rows in the payload

Delivery

Headers

Retries

URL rules

Receiver checklist

Polling fallback

Errors