subscriptions resource type (Beta)

Important

The finance reports API is announced as deprecated starting with Business Central 2026 release wave 2 and will be removed in Business Central 2027 release wave 1. We recommend that you transition to the Analytics API instead. Learn more in Analytics API overview.

Represents a subscriptions in Business Central.

Note

For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central.

Methods

Method	Return Type	Description
GET subscriptions	subscriptions	Gets a subscriptions object.
DELETE subscriptions	none	Deletes a subscriptions object.
POST subscriptions	subscriptions	Creates a subscriptions object.
PATCH subscriptions	subscriptions	Updates a subscriptions object.

Properties

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.
timestamp	int64
userId	GUID	The ID of user that has created the subscriptions.
lastModifiedDateTime	datetime	The last datetime the subscriptions was modified. Read-Only.
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.
systemCreatedAt	datetime	The datetime the company was created.
systemCreatedBy	GUID	The ID of the user who created the company.
systemModifiedAt	datetime	The last datetime the subscriptions was modified.
systemModifiedBy	GUID	The ID of the user who last modified the company.

JSON representation

Here is a JSON representation of the subscriptions resource.

{
    "subscriptionId": "string",
    "notificationUrl": "string",
    "resource": "string",
    "timestamp": "int64",
    "userId": "GUID",
    "lastModifiedDateTime": "datetime",
    "clientState": "string",
    "expirationDateTime": "datetime",
    "systemCreatedAt": "datetime",
    "systemCreatedBy": "GUID",
    "systemModifiedAt": "datetime",
    "systemModifiedBy": "GUID"
}

Related information

GET subscriptions DELETE subscriptions POST subscriptions PATCH subscriptions