Update webhook registrations (API)

PUT /api/WebhookRegistrations/{registrationId}

This call updates the webhooks you are registered to.

Request URL

https:// .../api/WebhookRegistrations/{registrationId}

JSON response

{
  "registrationId": "00000000-0000-0000-0000-000000000000",
  "requestId": "00000000-0000-0000-0000-000000000000",
  "callBackUrl": "string",
  "callBackUserName": "string",
  "callBackPassword": "string",
  "merchantId": "00000000-0000-0000-0000-000000000000",
  "isActive": true,
  "deactivatedAt": "2020-12-16T09:31:35.628Z",
  "isInErrorState": true,
  "errorStateReason": "string",
  "detectedErrorStateAt": "2020-12-16T09:31:35.628Z"
}

Attributes

Attribute

Description

registrationId
string

ID of a webhook registration.

requestId
string

GUID that accompanies every request.

callBackUrl
string

The URL that will receive messages in return.

callBackUserName
string

Authentication data that accompanies webhook API calls if the server requires authentication.

callBackPassword
string

Authentication data that accompanies webhook API calls if the server requires authentication.

merchantId
string

Unique identifier for the merchant.

isActive
boolean

Whether a webhook is active.
True if it's active, otherwise false.

deactivatedAt
date

Returns the date and time a webhook was deactivated.

isInErrorState
boolean

Whether a webhook is in an error state.
True if the webhook is in an error state, otherwise false.

errorStateReason
string

Returns the reason that a webhook is in an error status.

detectedErrorStateAt
date

The moment that an error was detected. This is important information when troubleshooting a problem.


Did this page help you?