---
title: Destinations
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[Alerting](https://developers.cloudflare.com/api/go/resources/alerting)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Destinations

#### DestinationsEligible

##### [Get delivery mechanism eligibility](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/eligible/methods/get)

client.Alerting.Destinations.Eligible.Get(ctx, query) (\*[DestinationEligibleGetResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.eligible%20%3E%20(model)%20DestinationEligibleGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/alerting/v3/destinations/eligible

#### DestinationsPagerduty

##### [List PagerDuty services](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/pagerduty/methods/get)

client.Alerting.Destinations.Pagerduty.Get(ctx, query) (\*SinglePage\[[Pagerduty](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/alerting/v3/destinations/pagerduty

##### [Create PagerDuty integration token](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/pagerduty/methods/create)

client.Alerting.Destinations.Pagerduty.New(ctx, body) (\*[DestinationPagerdutyNewResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20DestinationPagerdutyNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/alerting/v3/destinations/pagerduty/connect

##### [Delete PagerDuty Services](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/pagerduty/methods/delete)

client.Alerting.Destinations.Pagerduty.Delete(ctx, body) (\*[DestinationPagerdutyDeleteResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20DestinationPagerdutyDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/alerting/v3/destinations/pagerduty

##### [Connect PagerDuty](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/pagerduty/methods/link)

client.Alerting.Destinations.Pagerduty.Link(ctx, tokenID, query) (\*[DestinationPagerdutyLinkResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20DestinationPagerdutyLinkResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/alerting/v3/destinations/pagerduty/connect/{token\_id}

##### ModelsExpand Collapse

<details>

<summary>

type Pagerduty struct{…}

</summary>

ID stringOptional

UUID

maxLength32

<a href="#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

Name stringOptional

The name of the pagerduty service.

<a href="#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

</details>

[Link to this property](<#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty%20%3E%20(schema)>)

#### DestinationsWebhooks

##### [List webhooks](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/webhooks/methods/list)

client.Alerting.Destinations.Webhooks.List(ctx, query) (\*SinglePage\[[Webhooks](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/alerting/v3/destinations/webhooks

##### [Get a webhook](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/webhooks/methods/get)

client.Alerting.Destinations.Webhooks.Get(ctx, webhookID, query) (\*[Webhooks](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/alerting/v3/destinations/webhooks/{webhook\_id}

##### [Create a webhook](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/webhooks/methods/create)

client.Alerting.Destinations.Webhooks.New(ctx, params) (\*[DestinationWebhookNewResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20DestinationWebhookNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/alerting/v3/destinations/webhooks

##### [Update a webhook](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/webhooks/methods/update)

client.Alerting.Destinations.Webhooks.Update(ctx, webhookID, params) (\*[DestinationWebhookUpdateResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20DestinationWebhookUpdateResponse%20%3E%20(schema)>), error)

PUT/accounts/{account\_id}/alerting/v3/destinations/webhooks/{webhook\_id}

##### [Delete a webhook](https://developers.cloudflare.com/api/go/resources/alerting/subresources/destinations/subresources/webhooks/methods/delete)

client.Alerting.Destinations.Webhooks.Delete(ctx, webhookID, body) (\*[DestinationWebhookDeleteResponse](<https://developers.cloudflare.com/api/go/resources/alerting#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20DestinationWebhookDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/alerting/v3/destinations/webhooks/{webhook\_id}

##### ModelsExpand Collapse

<details>

<summary>

type Webhooks struct{…}

</summary>

ID stringOptional

The unique identifier of a webhook

maxLength32

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

CreatedAt TimeOptional

Timestamp of when the webhook destination was created.

formatdate-time

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

LastFailure TimeOptional

Timestamp of the last time an attempt to dispatch a notification to this webhook failed.

formatdate-time

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20last_failure">Link to this property</a>

LastSuccess TimeOptional

Timestamp of the last time Cloudflare was able to successfully dispatch a notification using this webhook.

formatdate-time

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20last_success">Link to this property</a>

Name stringOptional

The name of the webhook destination. This will be included in the request body when you receive a webhook notification.

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

Secret stringOptional

Optional secret that will be passed in the <code>cf-webhook-auth</code> header when dispatching generic webhook notifications or formatted for supported destinations. Secrets are not returned in any API response body.

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20secret">Link to this property</a>

<details>

<summary>

Type WebhooksTypeOptional

Type of webhook endpoint.

</summary>

One of the following:

const WebhooksTypeDatadog WebhooksType = "datadog"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

const WebhooksTypeDiscord WebhooksType = "discord"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

const WebhooksTypeFeishu WebhooksType = "feishu"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%202">Link to this property</a>

const WebhooksTypeGchat WebhooksType = "gchat"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%203">Link to this property</a>

const WebhooksTypeGeneric WebhooksType = "generic"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%204">Link to this property</a>

const WebhooksTypeOpsgenie WebhooksType = "opsgenie"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%205">Link to this property</a>

const WebhooksTypeSlack WebhooksType = "slack"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%206">Link to this property</a>

const WebhooksTypeSplunk WebhooksType = "splunk"

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%207">Link to this property</a>

</details>

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

URL stringOptional

The POST endpoint to call when dispatching a notification.

<a href="#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)%20%3E%20(property)%20url">Link to this property</a>

</details>

[Link to this property](<#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)>)