When webhook url will be marked as invalid?

[KevinHoang]

Hi all,

The docs say: “We mark a URL as invalid if it fails the daily validation check. In order to re-enable the URL, call the update endpoint.”

But it’s not clear, so I would like to know when webhook url will be marked as invalid?

[LeBraat]

Hello @KevinHoang,

I do agree that the wording here is a little confusing. We will adjust accordingly.

There are a few different points in time that we run a Challenge-Response Check (CRC) to make sure that the proper web app is running and accepting data. This CRC occurs when a webhook URL is registered, on an approximately hourly basis while the webhook URL is validated, and when you manually trigger a CRC using the ‘Manually triggers a challenge response check’ PUT request.

If your system doesn’t respond within three seconds of this CRC or responds incorrectly, then your webhook URL will be invalidated and will not receive any further activities. To re-validate your webhook URL, please manually trigger a CRC again.

Please let me know if this makes sense.

[KevinHoang]

This CRC occurs when a webhook URL is registered, on an approximately hourly basis while the webhook URL is validated, and when you manually trigger a CRC using the ‘Manually triggers a challenge response check’ PUT request

Thank you so much, @LeBraat
If I have a valid webhook url (already registered), and no PUT request. My webhook url will never be invalid, right?

[LeBraat]

If your web app doesn’t respond with the proper response or doesn’t respond within 3 seconds of our automated ~hourly CRC, then your webhook URL will become invalidated, at which time you can manually trigger a CRC with the PUT request.

You can read all about this within our guides section of our Account Activity API docs.

[KevinHoang]

Thanks @LeBraat,

I got it.
I stop my api service for testing (my webhook URL is not available in almost a day), but, my webhook URL doesn’t become invalidated. So I’m confusing and need your help to know why’s that?

Sorry for any inconvenience, I need to determine whether I need to monitor my webhook url to make sure the webhook url is always available, or not.

[LeBraat]

Can you please let me know what you mean by the following?

my webhook URL is not available in almost a day

and

my webhook URL doesn’t become invalidated

[KevinHoang]

So sorry @LeBraat

my webhook URL is not available in almost a day

I mean: My webhook url is stopped and doesn’t response if Twitter does CRC check.

my webhook URL doesn’t become invalidated

After I stopped My webhook url for almost a day, I use “GET account_activity/all/webhooks” and I see that my webhook url still valid=true.

And now (after ~3 days stopped), my webhook url become invalidated.

One more question: Is there any official way to monitor my webhook url, such as a notify event?