Update an event destination v2

Core Resources
Event Destinations
Update an event destination

Update the details of an event destination.

Learn more about calling API v2 endpoints.

Parameters

  • idstringRequired

    Identifier for the event destination to update.

  • descriptionstring

    An optional description of what the event destination is used for.

  • enabled_eventsarray of strings

    The list of events to enable for this endpoint.

  • includearray of enums

    Additional fields to include in the response. Currently supports webhook_endpoint.url.

    Possible enum values
    webhook_endpoint.url

    Include parameter to expose webhook_endpoint.url.

  • metadatamap

    Metadata.

  • namestring

    Event destination name.

  • webhook_endpointobject

    Webhook endpoint configuration.

    • webhook_endpoint.urlstringRequired

      The URL of the webhook endpoint.

Returns

Response attributes

  • idstring

    Unique identifier for the object.

  • objectstring, value is "v2.core.event_destination"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • amazon_eventbridgenullable object

    Amazon EventBridge configuration.

    • amazon_eventbridge.aws_account_idstring

      The AWS account ID.

    • amazon_eventbridge.aws_event_source_arnstring

      The ARN of the AWS event source.

    • amazon_eventbridge.aws_event_source_statusenum

      The state of the AWS event source.

      Possible enum values
      active

      The event source is in active state.

      deleted

      The event source is in deleted state.

      pending

      The event source is in pending state.

      unknown

      The event source state cannot be retrieved.

  • createdtimestamp

    Time at which the object was created.

  • descriptionstring

    An optional description of what the event destination is used for.

  • enabled_eventsarray of strings

    The list of events to enable for this endpoint.

  • event_payloadenum

    Payload type of events being subscribed to.

    Possible enum values
    snapshot

    Events from v1 APIs.

    thin

    Events from v2 APIs.

  • events_fromnullable array of enums

    Where events should be routed from.

    Possible enum values
    other_accounts

    Receive events from accounts connected to the account that owns the event destination.

    self

    Receive events from the account that owns the event destination.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

  • metadatanullable map

    Metadata.

  • namestring

    Event destination name.

  • snapshot_api_versionnullable string

    If using the snapshot event payload, the API version events are rendered as.

  • statusenum

    Status. It can be set to either enabled or disabled.

    Possible enum values
    disabled

    Event destination is disabled.

    enabled

    Event destination is enabled.

  • status_detailsnullable object

    Additional information about event destination status.

    • status_details.disablednullable object

      Details about why the event destination has been disabled.

      • status_details.disabled.reasonenum

        Reason event destination has been disabled.

        Possible enum values
        no_aws_event_source_exists

        Event destination has been disabled because the underlying AWS event source does not exist.

        user

        Event destination has been disabled by user.

  • typeenum

    Event destination type.

    Possible enum values
    amazon_eventbridge

    Amazon EventBridge.

    webhook_endpoint

    Webhook endpoint.

  • updatedtimestamp

    Time at which the object was last updated.

  • webhook_endpointnullable object

    Webhook endpoint configuration.

    • webhook_endpoint.signing_secretnullable string

      The signing secret of the webhook endpoint, only includable on creation.

    • webhook_endpoint.urlnullable string

      The URL of the webhook endpoint, includable.

Error Codes
404not_found

The resource wasn’t found.

409idempotency_error

An idempotent retry occurred with different request parameters.

POST /v2/core/event_destinations/:id
curl -X POST https://api.stripe.com/v2/core/event_destinations/ed_test_61RM8ltWcTW4mbsxf16RJyfa2xSQLHJJh1sxm7H0KVT6 \
-H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
-H "Stripe-Version: 2025-08-27.preview" \
--json '{
"description": "A better description",
"enabled_events": [
"v1.billing.meter.error_report_triggered",
"v1.billing.meter.no_meter_found"
],
"include": [
"webhook_endpoint.url"
]
}'
Response
{
"id": "ed_test_61RM8ltWcTW4mbsxf16RJyfa2xSQLHJJh1sxm7H0KVT6",
"object": "v2.core.event_destination",
"created": "2024-10-22T16:20:09.931Z",
"description": "A better description",
"enabled_events": [
"v1.billing.meter.error_report_triggered",
"v1.billing.meter.no_meter_found"
],
"event_payload": "thin",
"events_from": [
"self"
],
"livemode": false,
"metadata": {},
"name": "My Event Destination",
"snapshot_api_version": null,
"status": "disabled",
"status_details": {
"disabled": {
"reason": "user"
}
},
"type": "webhook_endpoint",
"updated": "2024-10-22T16:25:48.976Z",
"webhook_endpoint": {
"signing_secret": null,
"url": "https://example.com/my/webhook/endpoint"
}
}