Notification delivery

Notifications are sent as POST requests to subscribed webhook endpoints. To ensure successful delivery of notifications, it's important for receiving endpoints to respond quickly.

Squarespace guarantees "at least once delivery" of notifications on a best effort basis.

Successful vs. unsuccessful delivery

A notification delivery attempt is successful if Squarespace receives a 2xx status code from the webhook endpoint.

If the request times out or receives a status code other than 2xx, the delivery is unsuccessful and is retried. Squarespace attempts delivery several times for up to 48 hours.

Note: Squarespace may delete a webhook subscription if multiple requests are unsuccessful.

Duplicate notifications

In rare circumstances, webhook endpoints may receive a notification more than once. To gracefully handle duplicates, it is important for webhook endpoints to take this into account by tracking which notification ids have already been processed.

Order of notifications

Squarespace does not guarantee delivery in the order the events occurred, nor when the notifications were generated, as indicated by their createdOn field. Webhook endpoints should expect to receive notifications out of order, and handle them accordingly.