--- title: Destinations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Alerting](https://developers.cloudflare.com/api/python/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/python/resources/alerting/subresources/destinations/subresources/eligible/methods/get) alerting.destinations.eligible.get(EligibleGetParams\*\*kwargs) -> [EligibleGetResponse]() GET/accounts/{account\_id}/alerting/v3/destinations/eligible ##### ModelsExpand Collapse
Dict\[str, List\[EligibleGetResponseItem]] eligible: Optional\[bool] Determines whether or not the account is eligible for the delivery mechanism. Link to this property ready: Optional\[bool] Beta flag. Users can create a policy with a mechanism that is not ready, but we cannot guarantee successful delivery of notifications. Link to this property
type: Optional\[Literal\["email", "pagerduty", "webhook"]] Determines type of delivery mechanism. One of the following: "email" Link to this property "pagerduty" Link to this property "webhook" Link to this property
Link to this property
[Link to this property](<#(resource)%20alerting.destinations.eligible%20%3E%20(model)%20eligible_get_response%20%3E%20(schema)>) #### DestinationsPagerduty ##### [List PagerDuty services](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/pagerduty/methods/get) alerting.destinations.pagerduty.get(PagerdutyGetParams\*\*kwargs) -> SyncSinglePage\[[Pagerduty]()] GET/accounts/{account\_id}/alerting/v3/destinations/pagerduty ##### [Create PagerDuty integration token](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/pagerduty/methods/create) alerting.destinations.pagerduty.create(PagerdutyCreateParams\*\*kwargs) -> [PagerdutyCreateResponse]() POST/accounts/{account\_id}/alerting/v3/destinations/pagerduty/connect ##### [Delete PagerDuty Services](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/pagerduty/methods/delete) alerting.destinations.pagerduty.delete(PagerdutyDeleteParams\*\*kwargs) -> [PagerdutyDeleteResponse]() DELETE/accounts/{account\_id}/alerting/v3/destinations/pagerduty ##### [Connect PagerDuty](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/pagerduty/methods/link) alerting.destinations.pagerduty.link(strtoken\_id, PagerdutyLinkParams\*\*kwargs) -> [PagerdutyLinkResponse]() GET/accounts/{account\_id}/alerting/v3/destinations/pagerduty/connect/{token\_id} ##### ModelsExpand Collapse
class Pagerduty: … id: Optional\[str] UUID maxLength32 Link to this property name: Optional\[str] The name of the pagerduty service. Link to this property
[Link to this property](<#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty%20%3E%20(schema)>)
class PagerdutyCreateResponse: … id: Optional\[str] token in form of UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty_create_response%20%3E%20(schema)>)
class PagerdutyDeleteResponse: …
errors: List\[Error] message: str Link to this property code: Optional\[int] minimum1000 Link to this property
Link to this property
messages: List\[Message] message: str Link to this property code: Optional\[int] minimum1000 Link to this property
Link to this property success: Literal\[true] Whether the API call was successful Link to this property
[Link to this property](<#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty_delete_response%20%3E%20(schema)>)
class PagerdutyLinkResponse: … id: Optional\[str] UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.destinations.pagerduty%20%3E%20(model)%20pagerduty_link_response%20%3E%20(schema)>) #### DestinationsWebhooks ##### [List webhooks](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/webhooks/methods/list) alerting.destinations.webhooks.list(WebhookListParams\*\*kwargs) -> SyncSinglePage\[[Webhooks]()] GET/accounts/{account\_id}/alerting/v3/destinations/webhooks ##### [Get a webhook](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/webhooks/methods/get) alerting.destinations.webhooks.get(strwebhook\_id, WebhookGetParams\*\*kwargs) -> [Webhooks]() GET/accounts/{account\_id}/alerting/v3/destinations/webhooks/{webhook\_id} ##### [Create a webhook](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/webhooks/methods/create) alerting.destinations.webhooks.create(WebhookCreateParams\*\*kwargs) -> [WebhookCreateResponse]() POST/accounts/{account\_id}/alerting/v3/destinations/webhooks ##### [Update a webhook](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/webhooks/methods/update) alerting.destinations.webhooks.update(strwebhook\_id, WebhookUpdateParams\*\*kwargs) -> [WebhookUpdateResponse]() PUT/accounts/{account\_id}/alerting/v3/destinations/webhooks/{webhook\_id} ##### [Delete a webhook](https://developers.cloudflare.com/api/python/resources/alerting/subresources/destinations/subresources/webhooks/methods/delete) alerting.destinations.webhooks.delete(strwebhook\_id, WebhookDeleteParams\*\*kwargs) -> [WebhookDeleteResponse]() DELETE/accounts/{account\_id}/alerting/v3/destinations/webhooks/{webhook\_id} ##### ModelsExpand Collapse
class Webhooks: … id: Optional\[str] The unique identifier of a webhook maxLength32 Link to this property created\_at: Optional\[datetime] Timestamp of when the webhook destination was created. formatdate-time Link to this property last\_failure: Optional\[datetime] Timestamp of the last time an attempt to dispatch a notification to this webhook failed. formatdate-time Link to this property last\_success: Optional\[datetime] Timestamp of the last time Cloudflare was able to successfully dispatch a notification using this webhook. formatdate-time Link to this property name: Optional\[str] The name of the webhook destination. This will be included in the request body when you receive a webhook notification. Link to this property secret: Optional\[str] Optional secret that will be passed in the cf-webhook-auth header when dispatching generic webhook notifications or formatted for supported destinations. Secrets are not returned in any API response body. Link to this property
type: Optional\[Literal\["datadog", "discord", "feishu", 5 more]] Type of webhook endpoint. One of the following: "datadog" Link to this property "discord" Link to this property "feishu" Link to this property "gchat" Link to this property "generic" Link to this property "opsgenie" Link to this property "slack" Link to this property "splunk" Link to this property
Link to this property url: Optional\[str] The POST endpoint to call when dispatching a notification. Link to this property
[Link to this property](<#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhooks%20%3E%20(schema)>)
class WebhookCreateResponse: … id: Optional\[str] UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhook_create_response%20%3E%20(schema)>)
class WebhookUpdateResponse: … id: Optional\[str] UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhook_update_response%20%3E%20(schema)>)
class WebhookDeleteResponse: …
errors: List\[Error] message: str Link to this property code: Optional\[int] minimum1000 Link to this property
Link to this property
messages: List\[Message] message: str Link to this property code: Optional\[int] minimum1000 Link to this property
Link to this property success: Literal\[true] Whether the API call was successful Link to this property
[Link to this property](<#(resource)%20alerting.destinations.webhooks%20%3E%20(model)%20webhook_delete_response%20%3E%20(schema)>)