This event is fired when an Events Webhook URL is changed, whether via the UI or API or anywhere else.
This is for Cord to verify ownership of the Event Webhook URL you provided, and for you to confirm that your configuration is at least minimally working.
The event payload consists only of a string to aid debugging, which you can ignore.
⚠️
Creating a new Project with an eventWebhookURL
field via the REST API will skip the URL verification process. Your URL could be invalid.
Whenever you save a new events webhook URL via the Cord Console or set it through the API, a URL verification process will be triggered to ensure ownership of the URL and to check the URL works. We will attempt to send the following HTTP POST request to your URL:
projectID: 'your-project-id',
event: { message: 'Please respond with a HTTP 200 status code.' },
timestamp: '1725756888321',
type: 'url-verification'
Once you receive this event, verify the incoming event then respond with a HTTP 200 status code:
import { validateWebhookSignature } from '@cord-sdk/server';
validateWebhookSignature(req, <YOUR_CORD_PROJECT_SIGNING_SECRET>);
if (req.body.type === 'url-verification') {
res.sendStatus(200);
return;
}
The connection will be open for three seconds, during which time your app should respond to the request. If no response is received within three seconds, the verification process will fail and you will have to try again.
Not finding the answer you need? Ask our Developer Community