# Refresh a webhook subscription

This endpoint refreshes a webhook subscription.

NOTE

You can make a request to this endpoint by using the "refresh_url" provided in the response to the request to the confirm_a_webhook_subscription, refresh_a_webhook_subscription endpoints as well as in the notification message.

Method	Path	Operation*
PATCH	/notifications/webhooks/{account}?{token}	webhook_refresh_subscription

This endpoint does not require User Secret (API key) authorization.

# Request

Parameter	Type	In	Description
account required	string	path	Account UUID.
token required	string	query string	Unique subscription token generated by the system.
expires optional*	integer, `DEFAULT=604800`	body	Time in seconds when the notification subscription expires counted from the time of the creation of the subscription. The maximum and default value is 604800 seconds (7 days).

Attribute Type Description

callback_url string Target URL to which messages are to be delivered. It can have maximum 512 characters.

subscription

dictionary

Subscription details.

Attribute	Type	Description
topic	string	Name of the subscription topic. It must match the regular expression (opens new window) `[0-9A-Za-z\.\-_]{0,127}`.
account	string	Account UUID.
validity_ts	timestamp	Time at which the subscription expires. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).
unsubscribe_url	string	URL to unsubscribe from a subscription.
refresh_url	string	URL to refresh a subscription.

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.