8000 Adds new specifications for 'Events with Email' documentation by pablo-encinas · Pull Request #29203 · DataDog/documentation · GitHub
[go: up one dir, main page]
Skip to content

Adds new specifications for 'Events with Email' documentation #29203

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
May 13, 2025
+15 −1
Merged

Adds new specifications for 'Events with Email' documentation #29203

Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
abb4873
Update email.md
pablo-encinas May 7, 2025
927e2ce
Update email.md
pablo-encinas May 7, 2025
c4a1af0
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
286daa0
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
7b4692b
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
25b763a
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
2d4a440
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
aa7aac7
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
8d776ed
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
86ce20c
Update content/en/service_management/events/guides/email.md
pablo-encinas May 9, 2025
9567ba2
Moved section above links
pablo-encinas May 9, 2025
2e9be81
Added limits
pablo-encinas May 9, 2025
022b153
Add punctuation
buraizu May 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion content/en/service_management/events/guides/email.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,20 @@ Before you can send events with email, you need a dedicated email address from D
2. From the **Account** menu at the bottom left, select **Organization Settings**.
3. Click the **Events API emails** tab.
4. Choose the format for your messages from the **Format** dropdown (`Plain text` or `JSON`).
5. Click the **Create Email** button.
5. Optionally, define any of the other attributes listed in this page's [attribute definitions section](#attribute-definitions).
6. Click the **Create Email** button.

The **Events API emails** section displays all the emails available for your applications and who created them.

### Attribute definitions

| Name | Description | Example |
|---|---|---|
| Description | A description of the email's purpose. | "Used for MyService notifications" |
| Tags | List of tags to be appended to each event received through the email. If other tags are present in the JSON message, they are all added.<br>There is a limit of **20** tags per email. | `tag1:val1`, `tag2:val2` |
| Recipients | List of handles to be added to the beginning of the message for all events created through the email, without `@` prefix. For more information, see [Notification recipients][7].<br>There is a limit of **10** recipients per email. | `my@email.com`, `slack-acc-ch` |
| Alert Type | The alert type for events created from the event email. When present, the `alertType` field in a JSON email takes precedence over any other `alertType` values. | `Info` |

## Submission

There are two different ways to send events with email:
Expand Down Expand Up @@ -119,8 +129,12 @@ http://example.com/session_id%3A123456
### Email size
The maximum allowed email size, including content and attachments, is 20MB. Emails exceeding this limit are ignored.

### Usage tracking
To understand which emails are being used and receiving events, check the `Last Used` column in the **Events API Emails** tab in organization settings. This displays the most recent date that an email was processed for each address, or `No data` if there are no records of it being used.

[1]: /integrations/
[2]: /agent/agent_checks/
[3]: https://app.datadoghq.com
[5]: http://daringfireball.net/projects/markdown/syntax#lin
[6]: /integrations/guide/events-from-sns-emails/
[7]: /monitors/notify/#notification-recipients
Loading
0