Webhooks

Webhooks allow you to receive real-time notifications when specific events occur in LILT. When you configure a webhook, LILT sends an HTTP POST request to your specified URL whenever a subscribed event is triggered.

Event Types

You can subscribe to the following event types when creating a webhook configuration:

Event Type	Description
`JOB_UPDATE`	Triggered when a job is updated
`JOB_DELIVER`	Triggered when a job is delivered
`PROJECT_UPDATE`	Triggered when a project is updated
`PROJECT_DELIVER`	Triggered when a project is delivered
`INSTANT_TRANSLATE_COMPLETED`	Triggered when instant file translation task completes successfully
`INSTANT_TRANSLATE_FAILED`	Triggered when instant file translation task fails

Payload Structure

The payload sent to your webhook URL is a JSON object. The structure varies depending on the event type. Job and project event payloads do not include an explicit event type field, so you must infer the event type from the fields present in the payload. Instant translate event payloads include an eventType field.

JOB_UPDATE

Sent when a job is updated.

{
  "OrganizationId": 9,
  "due": "2025-03-28T10:32:31Z",
  "id": 895890,
  "isDelivered": 0,
  "name": "Marketing Brochure Q1 - English to German"
}

Field	Type	Description
`OrganizationId`	integer	The ID of the organization
`due`	string	The due date in ISO 8601 format
`id`	integer	The job ID
`isDelivered`	integer	Delivery status (`0` = not delivered)
`name`	string	The job name

JOB_DELIVER

Sent when a job is delivered.

{
  "OrganizationId": 9,
  "deliveredAt": "2025-03-24T08:10:55Z",
  "due": "2025-03-24T10:35:01Z",
  "id": 895892,
  "isDelivered": 1,
  "name": "Product Manual v2.0 - English to French"
}

Field	Type	Description
`OrganizationId`	integer	The ID of the organization
`deliveredAt`	string	The delivery timestamp in ISO 8601 format
`due`	string	The due date in ISO 8601 format
`id`	integer	The job ID
`isDelivered`	integer	Delivery status (`1` = delivered)
`name`	string	The job name

PROJECT_UPDATE

Sent when a project is updated.

{
  "OrganizationId": 9,
  "id": 37654,
  "name": "Website Localization - Spring Release",
  "due": "2025-03-20T13:47:09.000Z"
}

Field	Type	Description
`OrganizationId`	integer	The ID of the organization
`id`	integer	The project ID
`name`	string	The project name
`due`	string	The due date in ISO 8601 format

PROJECT_DELIVER

Sent when a project is delivered.

{
  "OrganizationId": 9,
  "id": 1376873
}

Field	Type	Description
`OrganizationId`	integer	The ID of the organization
`id`	integer	The project ID

INSTANT_TRANSLATE_COMPLETED

Sent when an instant file translation task completes successfully.

{
  "eventType": "INSTANT_TRANSLATE_COMPLETED",
  "translationId": 1376873,
  "fileId": 68754
}

Field	Type	Description
`eventType`	string	The type of event
`translationId`	integer	Instant file translation ID
`fileId`	integer	ID of the file translated

INSTANT_TRANSLATE_FAILED

Sent when an instant file translation task fails.

{
  "eventType": "INSTANT_TRANSLATE_FAILED",
  "translationId": 1376873,
  "fileId": 68754
}

Field	Type	Description
`eventType`	string	The type of event
`translationId`	integer	Instant file translation ID
`fileId`	integer	ID of the file translated

Distinguishing Event Types

Instant translate events include an eventType field in the payload. For job and project events, which do not include an explicit event type field, use the following logic to determine which event triggered the webhook:

If the payload contains…	Event Type
`isDelivered: 1` and `deliveredAt`	`JOB_DELIVER`
`isDelivered: 0` and `name` (job name)	`JOB_UPDATE`
`name` (project name) and `due`, but no `isDelivered`	`PROJECT_UPDATE`
Only `OrganizationId` and `id`	`PROJECT_DELIVER`

If you need to handle multiple event types, consider subscribing to each event type with a separate webhook configuration pointing to distinct endpoints. This removes the need to infer the event type from the payload structure.

Docs

API Reference

Event Types

Payload Structure

JOB_UPDATE

JOB_DELIVER

PROJECT_UPDATE

PROJECT_DELIVER

INSTANT_TRANSLATE_COMPLETED

INSTANT_TRANSLATE_FAILED

Distinguishing Event Types

​Event Types

​Payload Structure

​JOB_UPDATE

​JOB_DELIVER

​PROJECT_UPDATE

​PROJECT_DELIVER

​INSTANT_TRANSLATE_COMPLETED

​INSTANT_TRANSLATE_FAILED

​Distinguishing Event Types

Event Types

Payload Structure

JOB_UPDATE

JOB_DELIVER

PROJECT_UPDATE

PROJECT_DELIVER

INSTANT_TRANSLATE_COMPLETED

INSTANT_TRANSLATE_FAILED

Distinguishing Event Types