Webhook Event & Payloads

About Webhook Events

In the context of webhooks, event filtering refers to the ability to selectively trigger webhooks based on specific occurrences or actions within the source system. Rather than sending notifications for all possible events, developers can set up webhooks to respond only to certain predefined events that are relevant to their application. This filtering mechanism ensures that the receiving system is notified only about events it cares about, optimizing the use of resources and reducing unnecessary data processing

Webhook Event Headers

• X-Signature-SHA256: Used to verify the webhook payload is from Xometry. The header is a generated hash signature of the requesting body with a timestamp using SHA-256.

Events

Job Created

Job Created Trigger

• On Xometry job acceptance or in-house job creation

Job Created Payload

{
    "resource": "653aab43bb4aee00089de3e1",
    "resourceType": "job",
    "object": {
        "resource": "6555144a7134790007f8861e",
        "resourceType": "job",
        "object": {
            "id": "J0000000",
            "guid": "6555144a7134790007f8861e"
        }
    },
    "event": "job.created"
}

Job Revised

Job Revised Trigger

• On update of the following fields: xometry_vqc_required xometry_shipping, xometry_files , xometry_finalInspection. Note: As a result of this revision event, other job details not listed in these fields may have also been updated.

Job Revised Payload

{
    "resource": "653aab43bb4aee00089de3e1",
    "resourceType": "job",
    "object": {
        "resource": "6555144a7134790007f8861e",
        "resourceType": "job",
        "object": {
            "id": "J0000000",
            "guid": "6555144a7134790007f8861e",
          	"stageIds": ["xometry_shipping"],
        }
    },
    "event": "job.revised"
}

Job Status Updated

Job Status Updated Trigger

• On update of a job status

Job Status Updated Payload

{
  "resource": "65cd18881d5cf3000704ce55",
  "resourceType": "job",
  "object": {
    "id": "J0000000",
    "guid": "65cd18881d5cf3000704ce55",
    "orderStatus": {
      "from": "progress",
      "to": "error"
    }
  },
  event: "job.statusUpdated"
}