When do Job Failure Webhooks trigger?

Last updated: December 17, 2024

Job Failure Webhooks are a powerful tool for monitoring and responding to issues in your integration with Propexo. This article explains when these webhooks trigger and how you can use them.

What triggers a Job Failure Webhook?

Job Failure Webhooks trigger in the following scenarios:

  • When sync jobs fail after multiple retry attempts

  • When POST operations fail, such as creating a charge

  • When there are permission issues with the PMS integration

How can you use Job Failure Webhooks?

Job Failure Webhooks provide immediate notification when a job fails, allowing you to:

  • Quickly identify and respond to integration issues

  • Monitor the health of your Propexo integration

  • Automate error handling and reporting processes

Identifying failed jobs

When a Job Failure Webhook is triggered, it includes the same job_id that was returned in the original API response. This allows you to easily correlate the failed job with the original request.

While you can always query job status manually, Job Failure Webhooks provide immediate notification without the need for polling.

Setting up Job Failure Webhooks

To set up Job Failure Webhooks, navigate to the Webhooks section in your Propexo dashboard and configure the endpoint where you want to receive these notifications.

By leveraging Job Failure Webhooks, you can ensure that you're promptly notified of any issues with your Propexo integration, allowing for quick resolution and minimal disruption to your operations.