---
title: servicenow.event() function
description: servicenow.event() sends an event to ServiceNow.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/bonitoo-io/servicenow/event/
estimated_tokens: 2939
product: Flux
version: v0
---

# servicenow.event() function

-   Flux 0.136.0+
-   View InfluxDB support

`servicenow.event()` is a user-contributed function maintained by the [package author](#package-author-and-maintainer).

`servicenow.event()` sends an event to [ServiceNow](https://servicenow.com/).

ServiceNow Event API fields are described in [ServiceNow Create Event documentation](https://docs.servicenow.com/bundle/paris-it-operations-management/page/product/event-management/task/t_EMCreateEventManually.html).

##### Function type signature

```js
(
    description: A,
    password: string,
    severity: B,
    url: string,
    username: string,
    ?additionalInfo: C,
    ?messageKey: D,
    ?metricName: E,
    ?metricType: F,
    ?node: G,
    ?resource: H,
    ?source: I,
) => int where B: Equatable, C: Equatable
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### url

(Required) ServiceNow web service URL.

### username

(Required) ServiceNow username to use for HTTP BASIC authentication.

### password

(Required) ServiceNow password to use for HTTP BASIC authentication.

### description

(Required) Event description.

### severity

(Required) Severity of the event.

Supported values:

-   `critical`
-   `major`
-   `minor`
-   `warning`
-   `info`
-   `clear`

### source

Source name. Default is `"Flux"`.

### node

Node name or IP address related to the event. Default is an empty string (`""`).

### metricType

Metric type related to the event (for example, `CPU`). Default is an empty string (`""`).

### resource

Resource related to the event (for example, `CPU-1`). Default is an empty string (`""`).

### metricName

Metric name related to the event (for example, `usage_idle`). Default is an empty string (`""`).

### messageKey

Unique identifier of the event (for example, the InfluxDB alert ID). Default is an empty string (`""`). If an empty string, ServiceNow generates a value.

### additionalInfo

Additional information to include with the event.

## Examples

### Send the last reported value and incident type to ServiceNow

```js
import "contrib/bonitoo-io/servicenow"
import "influxdata/influxdb/secrets"

username = secrets.get(key: "SERVICENOW_USERNAME")
password = secrets.get(key: "SERVICENOW_PASSWORD")

lastReported =
    from(bucket: "example-bucket")
        |> range(start: -1m)
        |> filter(fn: (r) => r._measurement == "cpu" and r._field == "usage_idle")
        |> last()
        |> findRecord(fn: (key) => true, idx: 0)

servicenow.event(
    url: "https://tenant.service-now.com/api/global/em/jsonv2",
    username: username,
    password: password,
    node: lastReported.host,
    metricType: lastReported._measurement,
    resource: lastReported.instance,
    metricName: lastReported._field,
    severity:
        if lastReported._value < 1.0 then
            "critical"
        else if lastReported._value < 5.0 then
            "warning"
        else
            "info",
    additionalInfo: {"devId": r.dev_id},
)
```

[single notification](/flux/v0/tags/single-notification/)