---
title: pagerduty.endpoint() function
description: >
  The `pagerduty.endpoint()` function sends a message to PagerDuty that includes output data.
aliases:
  - /influxdb/v2.0/reference/flux/functions/pagerduty/endpoint/
  - /influxdb/v2.0/reference/flux/stdlib/pagerduty/endpoint/
  - /influxdb/cloud/reference/flux/stdlib/pagerduty/endpoint/
menu:
  flux_0_x_ref:
    name: pagerduty.endpoint
    parent: pagerduty
weight: 202
flux/v0.x/tags: [notification endpoints]
introduced: 0.43.0
---

The `pagerduty.endpoint()` function returns a function that can be used to send
a message to PagerDuty that includes output data.

```js
import "pagerduty"

pagerduty.endpoint(
    url: "https://events.pagerduty.com/v2/enqueue"
)
```

## Parameters

### url {data-type="string"}
PagerDuty v2 Events API URL.
Default is `https://events.pagerduty.com/v2/enqueue`.

## Usage
`pagerduty.endpoint` is a factory function that outputs another function.
The output function requires a `mapFn` parameter.
See the [PagerDuty v2 Events API documentation](https://developer.pagerduty.com/api-reference/reference/events-v2/openapiv3.json)
for more information about these parameters.

### mapFn {data-type="function"}
({{< req >}}) A function that builds the record used to generate the POST request.
Requires an `r` parameter.

`mapFn` accepts a table row (`r`) and returns a record that must include the following fields:

- `routingKey`
- `client`
- `client_url`
- `class`
- `eventAction`
- `group`
- `severity`
- `component`
- `source`
- `summary`
- `component`
- `timestamp`
- `customDetails`

_For more information, see [`pagerduty.sendEvent()`](/flux/v0.x/stdlib/pagerduty/sendevent/)_

## Examples

##### Send critical statuses to a PagerDuty endpoint
```js
import "pagerduty"
import "influxdata/influxdb/secrets"

routingKey = secrets.get(key: "PAGERDUTY_ROUTING_KEY")
toPagerDuty = pagerduty.endpoint()

crit_statuses = from(bucket: "example-bucket")
    |> range(start: -1m)
    |> filter(fn: (r) => r._measurement == "statuses" and r.status == "crit")

crit_statuses
    |> toPagerDuty(
        mapFn: (r) => ({r with
            routingKey: routingKey,
            client: r.client,
            clientURL: r.clientURL,
            class: r.class,
            eventAction: r.eventAction,
            group: r.group,
            severity: r.severity,
            component: r.component,
            source: r.source,
            summary: r.summary,
            component: r.component,
            timestamp: r._time,
            customDetails: {"ping time": lastReported.ping, load: lastReported.load},
        }),
    )()
```