For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/events/post-an-event.md. A documentation index is available at /llms.txt.
homeHomedocsDocsapiAPI
Language
Datadog site

Post an event

POSThttps://event-management-intake.datadoghq.com/api/v2/eventshttps://event-management-intake.us3.datadoghq.com/api/v2/eventshttps://event-management-intake.us5.datadoghq.com/api/v2/eventshttps://event-management-intake.datadoghq.eu/api/v2/eventshttps://event-management-intake.ap1.datadoghq.com/api/v2/eventshttps://event-management-intake.ap2.datadoghq.com/api/v2/eventshttps://event-management-intake.uk1.datadoghq.com/api/v2/eventshttps://event-management-intake.ddog-gov.com/api/v2/eventshttps://event-management-intake.us2.ddog-gov.com/api/v2/events

Overview

This endpoint allows you to publish events.

Note: To utilize this endpoint with our client libraries, please ensure you are using the latest version released on or after July 1, 2025. Earlier versions do not support this functionality.

Important: Upgrade to the latest client library version to use the updated endpoint at https://event-management-intake.{site}/api/v2/events. Older client library versions of the Post an event (v2) API send requests to a deprecated endpoint (https://api.{site}/api/v2/events).

Supported event categories are change and alert. For more information about change events, see Change Tracking.

Request

Body Data (required)

Event creation request payload.

Field
Type
Description
data [required]
object

An event object.

Response

OK

Event creation response.

Field
Type
Description
data
object

Event object.

links
object

Links to the event.

Code Example

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
export DD_API_KEY="<DD_API_KEY>"
export DD_APP_KEY="<DD_APP_KEY>"

curl -X POST "https://event-management-intake.${DD_SITE}/api/v2/events" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "aggregation_key": "deduplication_key_here",
      "attributes": {
        "custom": {
          "my-object-attribute": {
            "my-array-attribute": [
              1,
              2,
              3
            ],
            "my-array-object-attribute": [
              {
                "name": "test-object-1"
              },
              {
                "name": "test-object-2"
              }
            ],
            "my-integer-attribute": 1
          },
          "my-string-attribute": "my-custom-value"
        },
        "links": [
          {
            "category": "runbook",
            "title": "Datadog website",
            "url": "https://datadoghq.com"
          }
        ],
        "priority": "1",
        "status": "error"
      },
      "category": "alert",
      "message": "Something is broken!",
      "tags": [
        "service:my-test-service",
        "datacenter:primary"
      ],
      "title": "My Alerting Event"
    },
    "type": "event"
  }
}
EOF