Webhook

Outgoing Job Events

Webhook deliveries are JSON POST requests sent from Shiplah to your configured endpoint when visible delivery jobs change.

Events

Event	When it is sent
`delivery_job.created`	A visible delivery job is created.
`delivery_job.updated`	A visible delivery job is updated.
`delivery_job.status_changed`	The delivery job status changes.

Payload

{
  "event": "delivery_job.status_changed",
  "occurred_at": "2026-05-21T10:00:00.000Z",
  "organization": {
    "id": "org-id",
    "type": "upstream"
  },
  "job": {
    "id": "job-id",
    "marking_number": "MARK-001",
    "batch_number": "BATCH-001",
    "normalized_status": "completed",
    "updated_at": "2026-05-21T10:00:00.000Z"
  }
}

Payload Fields

Name	Type	Description
`event`	string	Webhook event name.
`occurred_at`	datetime	Event creation time.
`organization.id`	string	Organization id scoped to the webhook subscription.
`organization.type`	string	Organization type.
`job.id`	string	Delivery job id.
`job.marking_number`	string	Marking Number.
`job.batch_number`	string or null	Batch Number.
`job.normalized_status`	string	Current platform status code. See Reference.
`job.updated_at`	datetime	Latest job update time.

Authentication Options

The integrations page supports no auth, Basic auth, Bearer token, and a custom header. Secrets are stored by organization and are not shown after saving.