Webhook Notification Payload

The webhook notification that Visier sends to your registered endpoint contains authentication details and JSON content describing the event, such as job IDs and data version numbers.

Overview

When the configured event type occurs, Visier sends an API request to your registered endpoint. The API request payload contains authentication details and JSON content describing the event, such as job IDs and data version numbers.

Webhook notifications from Visier contain the following headers:

Authorization (optional): If you provided credentials for the webhook, Visier sends the Authorization header to authenticate against the receiving entity.
x-visier-signature: An HMAC signature generated from the provided keyName for the webhook.

Webhook notification for job success, failure, and reschedule events contain the following job ID fields:

jobId: The job that triggered the webhook notification.
rootJobId: The top-level job that eventually spawned the job that triggered the webhook notification.
parentJobId: The parent job of the job that triggered the webhook notification.

Example: Let's say Receiving Job A spawned Processing Job B. Processing Job B spawned Processing Job C. Processing Job C triggered the webhook notification. In this example:

jobId is Processing Job C.
rootJobId is Processing Job A.
parentJobId is Processing Job B.

For more information about jobs, see Jobs.

jobResultSuccess payload

The following code sample is an example of the API payload for a jobResultSuccess event type notification.

Copy

Payload for jobResultSuccess event type

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
    "timestamp": "1743718453610",
    "eventId": "c0c91580-ce09-40fd-8f84-39d8578c704b",
    "eventType": "jobResultSuccess",
    "event": {
        "jobid": "00000000-0000-0000-0000-000000000000",
        "rootJobId": "00000000-0000-0000-0000-000000000000",
        "parentJobId": "00000000-0000-0000-0000-000000000000",
        "tenantCode": "WFF_j1r",
        "jobType": "",
        "dataCategoryId": "00000000-0000-0000-0000-000000000000",
        "dataVersion": ""
    }
}

jobResultFailure payload

The following code sample is an example of the API payload for a jobResultFailure event type notification.

Copy

Payload for jobResultFailure event type

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
    "timestamp": "1743718453610",
    "eventId": "c0c91580-ce09-40fd-8f84-39d8578c704b",
    "eventType": "jobResultFailure",
    "event": {
        "jobid": "00000000-0000-0000-0000-000000000000",
        "rootJobId": "00000000-0000-0000-0000-000000000000",
        "parentJobId": "00000000-0000-0000-0000-000000000000",
        "tenantCode": "WFF_j1r",
        "jobType": "",
        "dataCategoryId": "00000000-0000-0000-0000-000000000000",
        "dataVersion": "",
        "message": ""
    }
}

jobResultRescheduled payload

The following code sample is an example of the API payload for a jobResultRescheduled event type notification.

Copy

Payload for jobResultRescheduled event type

1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "timestamp": "1743718453610",
    "eventId": "c0c91580-ce09-40fd-8f84-39d8578c704b",
    "eventType": "jobResultRescheduled",
    "event": {
        "jobid": "00000000-0000-0000-0000-000000000000",
        "rootJobId": "00000000-0000-0000-0000-000000000000",
        "parentJobId": "00000000-0000-0000-0000-000000000000",
        "tenantCode": "WFF_j1r",
        "jobType": "",
        "dataCategoryId": "00000000-0000-0000-0000-000000000000"
    }
}

dvPublish payload

The following code sample is an example of the API payload for a dvPublish event type notification.

Copy

Payload for dvPublish event type

1
2
3
4
5
6
7
8
9
10
{
    "timestamp": "1743718453610",
    "eventId": "c0c91580-ce09-40fd-8f84-39d8578c704b",
    "eventType": "dvPublish",
    "event": {
        "tenantCode": "WFF_j1r",
        "dataCategoryId": "00000000-0000-0000-0000-000000000000",
        "dataVersion": ""
    }
}