Skip to main content
To add an endpoint, provide a URL you control and select the event types you want to listen to.
  1. Navigate to the Webhooks page in the console.
  2. Click Add Endpoint.
  3. Provide the URL where you want to receive messages.
  4. Select the event types you want to listen to.
  5. Click Create.
Add an endpoint

FAQs

There are many events available to subscribe to from all our products. Some examples include:
  • Collection creation
  • NFT minting
  • NFT edits
  • Transaction confirmations
  • Transaction failures
You can see the full list of events in the Crossmint Console, under Integrate > Webhooks and the Event Catalog tab.
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.
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:
  • Immediately
  • 5 seconds
  • 5 minutes
  • 30 minutes
  • 2 hours
  • 5 hours
  • 10 hours
  • 10 hours (in addition to the previous)
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.Resend a webhook
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.
Some typical reasons why webhooks fail are:
  • Check that the enpdpoint URL is correct and that it’s expecting a POST request
  • Check that the endpoint is reachable from the public internet. Make sure that CSRF protection is disabled for this endpoint.
  • Check that the endpoint is returning a 2xx response code
  • Check that the payload signature and timestamp are verified correctly. Remember not to modify the body string of the webhook before processing it.
I