Configure an endpoint to receive webhook messages.
To add an endpoint, provide a URL you control and select the event types you want to listen to.
What types of events can I subscribe to with webhooks?
There are many events available to subscribe to from all our products. Some examples include:
You can see the full list of events in the Crossmint Console, under Integrate > Webhooks and the Event Catalog tab.
How can I verify that a webhook request is legitimate?
To verify a webhook request is legitimate, you need to verify the signature and timestamp. You can learn more about it in the Verify webhooks section.
How do I handle webhook retries?
Crossmint automatically retries webhooks if your endpoint doesn’t acknowledge its receipt, or throws an error. We will attempt to deliver the webhook 8 times:
If, after these attempts, we’re unable to deliver the message, we will mark it as failed. Inside the Webhooks page, you can manually resend the webhook.
What HTTP response code should my webhook endpoint return?
To indicate that a webhook has been processed, return a 2xx (status code 200-299) response to the webhook message within a 15 seconds timeframe.
Why are my webhooks failing?
Some typical reasons why webhooks fail are:
Configure an endpoint to receive webhook messages.
To add an endpoint, provide a URL you control and select the event types you want to listen to.
What types of events can I subscribe to with webhooks?
There are many events available to subscribe to from all our products. Some examples include:
You can see the full list of events in the Crossmint Console, under Integrate > Webhooks and the Event Catalog tab.
How can I verify that a webhook request is legitimate?
To verify a webhook request is legitimate, you need to verify the signature and timestamp. You can learn more about it in the Verify webhooks section.
How do I handle webhook retries?
Crossmint automatically retries webhooks if your endpoint doesn’t acknowledge its receipt, or throws an error. We will attempt to deliver the webhook 8 times:
If, after these attempts, we’re unable to deliver the message, we will mark it as failed. Inside the Webhooks page, you can manually resend the webhook.
What HTTP response code should my webhook endpoint return?
To indicate that a webhook has been processed, return a 2xx (status code 200-299) response to the webhook message within a 15 seconds timeframe.
Why are my webhooks failing?
Some typical reasons why webhooks fail are: