Signal
A signal: a saved batch request plus the schedule it is re-submitted on.
Returned by
#Fields
| Field | Type | Notes |
|---|---|---|
signal_id | string | UUID. |
name | string | Your label, may be empty. |
status | string | Enum: active, paused, completed. Derived: completed once completed_at is set, paused while active is false. |
active | boolean | false while paused, whether you paused it or Up2Data did. |
pause_reason | string | null | Enum: manual, insufficient_credits, invalid_request. null while active. |
schedule.interval_ms | integer | Milliseconds between runs. At least 60000. |
schedule.start_at | string | ISO 8601. When the first run fires. |
schedule.ends_at | string | null | ISO 8601. No run is scheduled after this instant. null for none. |
schedule.max_runs | integer | null | Total runs before the signal completes. null for indefinite. |
run_count | integer | Runs that reached Up2Data and were counted. Paused and deferred ticks do not count. |
next_run_at | string | null | ISO 8601. null once completed. |
last_run_at | string | null | ISO 8601. |
last_job_id | string | null | job_id of the batch job the most recent successful run created. |
last_error | string | null | Error from the most recent run, null after a success. |
completed_at | string | null | ISO 8601. |
request | object | The exact POST /batch body submitted on every run: items plus optional webhook_url. |
created_at | string | ISO 8601. |
updated_at | string | ISO 8601. |
#Sample
{
"signal_id": "9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11",
"name": "Watch key accounts",
"status": "active",
"active": true,
"pause_reason": null,
"schedule": { "interval_ms": 86400000, "start_at": "2026-11-01T08:00:00Z", "ends_at": null, "max_runs": 30 },
"run_count": 3,
"next_run_at": "2026-11-04T08:00:00Z",
"last_run_at": "2026-11-03T08:00:00Z",
"last_job_id": "job_7hd92kfa",
"last_error": null,
"completed_at": null,
"request": {
"items": [
{ "type": "profile", "url": "https://linkedin.com/in/a" },
{ "type": "company", "url": "https://linkedin.com/company/acme" }
],
"webhook_url": "https://your-server.com/hooks/up2data"
},
"created_at": "2026-10-30T12:00:00Z",
"updated_at": "2026-11-03T08:00:01Z"
}