Skip to main content


Locksmith implements Websub which allows anyone to receive real time updates from the [Unlock subgraphs]. It is a webhook system which many developers will be familiar with with built-in intent verification.

Currently, locksmith support sending updates on new locks and keys. To subscribe, an application will need to send a post request to the hubs located at /api/hooks/[topic]. The body needs to match the schema specified in the Websub w3c spec.

For examples on using the webhooks checkout the tutorial "Using Webhooks with the Locksmith API".

Currently the following topics are supported:

  • New Locks
  • New Keys
  • New Keys for a Lock

You need to replace network and lock with the respective network ID and Lock Address.