Skip to main content
This endpoint allows you to post events to the stream. Tag them, set priority and event aggregate them with other events.
This action does not support OAuth connections.
External DocumentationTo learn more, visit the Datadog documentation.

​
Basic Parameters

ParameterDescription
Alert TypeIf an alert event is enabled, set its type.
For example, error, warning, info, success, user_update,
recommendation, and snapshot.
Date HappenedPOSIX timestamp of the event. Must be sent as an integer (i.e. no quotes).
Limited to events no older than 7 days.
PriorityThe priority of the event. For example, normal or low.
TextThe body of the event. Limited to 4000 characters. The text supports markdown.
To use markdown in the event text, start the text block with %%% \n and end the text block with \n %%%.
Use msg_text with the Datadog Ruby library.
TitleThe event title. Limited to 100 characters. Use msg_title with the Datadog Ruby library.

​
Advanced Parameters

ParameterDescription
Aggregation KeyAn arbitrary string to use for aggregation. Limited to 100 characters.
If you specify a key, all events using that key are grouped together in the Event Stream.
Device NameA device name.
HostHost name to associate with the event.
Any tags associated with the host are also applied to this event.
IDInteger ID of the event.
PayloadPayload of the event.
Related Event IDID of the parent event. Must be sent as an integer (i.e. no quotes).
Source Type NameThe type of event being posted. Option examples include nagios, hudson, jenkins, my_apps, chef, puppet, git, bitbucket, etc.
A complete list of source attribute values available here.
TagsA list of tags to apply to the event.
URLURL of the event.

​
Example Output

{
	"status": "<string>",
	"event": {
		"id": 9180796796756298288,
		"id_str": "<string>",
		"title": "<string>",
		"text": "<string>",
		"date_happened": 1662347061,
		"handle": null,
		"priority": null,
		"related_event_id": null,
		"tags": null,
		"url": "<string>"
	}
}

​
Workflow Library Example

Create Event with Datadog and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop