New to Telerik Report Server? Start a free 30-day trial

POST api/reportserver/v3/data-alerts

Creates a new data alert.

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
Rules	Specifies the rules for the data alert.	Collection of DataAlertRule	Required
Name	Gets or sets the scheduled task name.	string	Required
Enabled	Gets or sets whether the scheduled task is either enabled or disabled.	boolean	None.
Reports	Gets or sets the reports which are rendered by the scheduled task.	Collection of ScheduledTaskReport	Required
StartDate	Obsolete since R2 2020. Use StartDateUtc property instead. Gets or sets the start date of the scheduled task in the author local time zone.	date	None.
StartDateUtc	Gets or sets the start date of the scheduled task in UTC.	date	None.
BaseUtcOffset	Gets or sets the UTC offset to the local timezone of the scheduled task author. Used for the mail templates date time type tokens.	decimal number	None.
RecurrenceRule	Gets or sets recurrence rule for the scheduled task.	RecurrenceRule	None.
LocalUsersMailTemplate	Gets or sets the mail template for local users. Set to null to use the default template.	TaskMailTemplateModel	None.
ExternalUsersMailTemplate	Gets or sets the mail template for external users. Set to null to use the default template.	TaskMailTemplateModel	None.
ExternalEmails	Gets or sets the emails of the external users to whom the report document should be sent.	Collection of string	None.
SubscriberIds	Provides a list of IDs of the users subscribed to the data alert.	Collection of string	None.

Request body formats

application/json, text/json, application/*+json

json

{
  "Rules": [
    {
      "Index": 75,
      "DataItemName": "Sales Reports",
      "Clauses": [
        {
          "Column": "TotalSales",
          "Operator": "is",
          "Value": "100"
        },
        {
          "Column": "Region",
          "Operator": "is",
          "Value": "100"
        }
      ]
    },
    {
      "Index": 81,
      "DataItemName": "HR Reports",
      "Clauses": [
        {
          "Column": "Region",
          "Operator": "is",
          "Value": "100"
        },
        {
          "Column": "TotalSales",
          "Operator": "is",
          "Value": "100"
        }
      ]
    }
  ],
  "Name": "Marketing Reports",
  "Enabled": true,
  "Reports": [
    {
      "ReportId": "339e841cff9",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    },
    {
      "ReportId": "a77f5639e9d",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    }
  ],
  "StartDate": "2026-08-12T14:15:59.8957051+00:00",
  "StartDateUtc": "2026-08-12T14:15:59.8957051Z",
  "BaseUtcOffset": 99.1,
  "RecurrenceRule": null,
  "LocalUsersMailTemplate": {
    "Subject": "Your scheduled report is ready",
    "Body": "The report you subscribed to has been generated and is attached to this email."
  },
  "ExternalUsersMailTemplate": {
    "Subject": "Your scheduled report is ready",
    "Body": "The report you subscribed to has been generated and is attached to this email."
  },
  "ExternalEmails": [
    "maria.garcia@example.com",
    "alex.johnson@example.com"
  ],
  "SubscriberIds": [
    "d358b61bd7e147a0bb8f2ed6d772642f",
    "31926c1d4c65471ca9f6b858cdff440e"
  ]
}

Response Information

Resource Description

DataAlert

Name	Description	Type	Additional information
Rules	Specifies the data alert rules.	Collection of DataAlertRule	Required
Id	Provides the scheduled task identifier.	string	Required
UserId	Specifies the ID of the user who has created the scheduled task.	string	None.
Name	Gets or sets the scheduled task name.	string	Required
Enabled	Gets or sets whether the scheduled task is either enabled or disabled.	boolean	None.
Reports	Gets or sets the reports which are rendered by the scheduled task.	Collection of ScheduledTaskReport	Required
StartDate	Obsolete since R2 2020. Use StartDateUtc property instead. Gets or sets the start date of the scheduled task in the author local time zone.	date	None.
StartDateUtc	Gets or sets the start date of the scheduled task in UTC.	date	None.
BaseUtcOffset	Gets or sets the UTC offset to the local timezone of the scheduled task author. Used for the mail templates date time type tokens.	decimal number	None.
RecurrenceRule	Gets or sets recurrence rule for the scheduled task.	RecurrenceRule	None.
LocalUsersMailTemplate	Gets or sets the mail template for local users. Set to null to use the default template.	TaskMailTemplateModel	None.
ExternalUsersMailTemplate	Gets or sets the mail template for external users. Set to null to use the default template.	TaskMailTemplateModel	None.
ExternalEmails	Gets or sets the emails of the external users to whom the report document should be sent.	Collection of string	None.
SubscriberIds	Provides a list of IDs of the users subscribed to the data alert.	Collection of string	None.

Response Formats

application/json

json

{
  "Rules": [
    {
      "Index": 75,
      "DataItemName": "Sales Reports",
      "Clauses": [
        {
          "Column": "TotalSales",
          "Operator": "is",
          "Value": "100"
        },
        {
          "Column": "Region",
          "Operator": "is",
          "Value": "100"
        }
      ]
    },
    {
      "Index": 81,
      "DataItemName": "HR Reports",
      "Clauses": [
        {
          "Column": "Region",
          "Operator": "is",
          "Value": "100"
        },
        {
          "Column": "TotalSales",
          "Operator": "is",
          "Value": "100"
        }
      ]
    }
  ],
  "Id": "8d742dd91c6",
  "UserId": "da0a1604386e430cb3d4af14290bde77",
  "Name": "Marketing Reports",
  "Enabled": true,
  "Reports": [
    {
      "ReportId": "339e841cff9",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    },
    {
      "ReportId": "a77f5639e9d",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    }
  ],
  "StartDate": "2026-08-12T14:15:59.8957051+00:00",
  "StartDateUtc": "2026-08-12T14:15:59.8957051Z",
  "BaseUtcOffset": 99.1,
  "RecurrenceRule": null,
  "LocalUsersMailTemplate": {
    "Subject": "Your scheduled report is ready",
    "Body": "The report you subscribed to has been generated and is attached to this email."
  },
  "ExternalUsersMailTemplate": {
    "Subject": "Your scheduled report is ready",
    "Body": "The report you subscribed to has been generated and is attached to this email."
  },
  "ExternalEmails": [
    "maria.garcia@example.com",
    "alex.johnson@example.com"
  ],
  "SubscriberIds": [
    "d358b61bd7e147a0bb8f2ed6d772642f",
    "31926c1d4c65471ca9f6b858cdff440e"
  ]
}