subscription resource type

NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0).

Represents a webhook subscription object in Dynamics 365 Business Central. Requests issued against the subscription entity, manages webhook subscriptions for a tenant.


Method Return Type Description
GET subscriptions Get subscriptions object.
POST subscriptions Create subscriptions object.
PATCH subscriptions Update subscriptions object.
DELETE subscriptions Delete subscriptions object.


Property Type Description
subscriptionId string Unique key for the subscription.
notificationUrl string URL to which webhook notifications are sent.
resource string URL for the resource being subscribed to. Supports relative and absolute URL.
userId GUID The ID of user that has created the subscription.
lastModifiedDateTime datetime Timestamp for when the subscription was modified.
clientState string Client state will be delivered with every notification. This can be used as a secret to verify message or for managing state if needed.
expirationDateTime datetime Date and time for when the webhook will expire.



JSON representation

Here is a JSON representation of the resource.

  "subscriptionId": "string",
  "notificationUrl": "string",
  "resource": "string",
  "userId": "Guid",
  "clientState": "string",
  "lastModifiedDateTime": "dateTimeOffset",
  "expirationDateTime": "dateTimeOffset"

See also

Error Codes
Get subscriptions
Create subscriptions
Update subscriptions
Delete subscriptions

Error Codes