Report Filing Service

<back to all web services

UpdateWebhookSubscription

UpdateSubscriptionsWebhooksSync

Represents a request to update a webhook subscription specified by its unique identifier.

Requires Authentication
The following routes are available for this service:
POST/sync/webhooks/subscriptions/{Id}/update
UpdateWebhookSubscriptionBase Parameters:
NameParameterData TypeRequiredDescription
IdformstringYesThe unique identifier of the subscriber.
NameformstringNoThe name of the subscription.
EventformstringNoThe name of the subscribed event.
UrlformstringNoThe callback URL to be called when an "event" of a certain type is going to be raised.
ContentTypeformstringNoThe MIME type of content pushed to the recipient service e.g. application/json
CurrentSecretformstringYesThe current secret that is used to sign and authenticate messages from webhook endpoints.
NewSecretformstringNoA random Base64-encoded secret key (8 or more characters) to sign and authenticate messages from webhook endpoints. .When receiving a webhook event in your subscribers service, calculate the HMAC signature of the request body using this secret. Compare the calculated signature with the signature included in the "X-Hub-Signature" header of the web hook event. If the signatures do not match, then disregard it, and don't process the request any further.
IsActiveformbool?NoIndicates whether the subscription is enabled or disabled.
PublicKeyXmlformstringYesThe XML-encoded RSA public key to encrypt the new secret of the webhook subscription. Note: Only the owner of the key pair (public and private encryption keys) can decrypt the encrypted secret with the private key! Encryption algorithm: RSA with OAEP-SHA256 padding.
SubscriptionResponse Parameters:
NameParameterData TypeRequiredDescription
SubscriptionformWebhookSubscriptionNoThe encapsulated webhook subscription of the response. The secret of the webhook subscription is encrypted and can only be decrypted by the owner of the private key.
HistoryformList<SubscriptionDeliveryResult>NoThe history of the subscription event.
ResponseStatusformResponseStatusNoThe status of the response.
WebhookSubscription Parameters:
NameParameterData TypeRequiredDescription
IdformstringNo
NameformstringNo
EventformstringNo
IsActiveformboolNo
CreatedDateUtcformDateTimeNo
CreatedByIdformstringNo
LastModifiedDateUtcformDateTimeNo
ConfigformSubscriptionConfigNo
SubscriptionConfig Parameters:
NameParameterData TypeRequiredDescription
UrlformstringNo
ContentTypeformstringNo
SecretformstringNo
SubscriptionDeliveryResult Parameters:
NameParameterData TypeRequiredDescription
AttemptedDateUtcformDateTimeNo
StatusDescriptionformstringNo
StatusCodeformHttpStatusCodeNo
SubscriptionIdformstringNo
IdformstringNo
EventIdformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .x-msgpack suffix or ?format=x-msgpack

HTTP + X-MSGPACK

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /sync/webhooks/subscriptions/{Id}/update HTTP/1.1 
Host: reportfiling.pwc.de 
Accept: application/x-msgpack
Content-Type: application/x-msgpack
Content-Length: length

{"id":"String","name":"String","event":"String","url":"String","contentType":"String","currentSecret":"String","newSecret":"String","isActive":false,"publicKeyXml":"String"}
HTTP/1.1 200 OK
Content-Type: application/x-msgpack
Content-Length: length

{"subscription":{"id":"String","name":"String","event":"String","isActive":false,"createdDateUtc":"\/Date(-62135596800000-0000)\/","createdById":"String","lastModifiedDateUtc":"\/Date(-62135596800000-0000)\/","config":{"url":"String","contentType":"String","secret":"String"}},"history":[{"attemptedDateUtc":"\/Date(-62135596800000-0000)\/","statusDescription":"String","statusCode":"Continue","subscriptionId":"String","id":"String","eventId":"String"}],"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}