Status Pages
Create an email access policy
Changed onCreates an email access policy for a private status page.
post/api/v2/statuspages/{page_id}/access_policies/email
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopesstatus_pages_settings_write
Path parameters
page_idstring uuid required
Example:1234abcd-12ab-34cd-56ef-123456abcdef
The ID of the private status page.
Query parameters
includestring
Comma-separated list of resources to include. Supported values: created_by_user, status_page.
Request body
Example request
{
"data": {
"attributes": {
"effect": "allow",
"pattern": "@example.com"
},
"type": "email_access_policies"
}
}Response
Created
Example response
{
"data": {
"attributes": {
"created_at": "2026-01-01T00:00:00.000Z",
"effect": "allow",
"pattern": "@example.com"
},
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"relationships": {
"created_by_user": {
"data": {
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"type": "users"
}
},
"status_page": {
"data": {
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"type": "status_pages"
}
}
},
"type": "email_access_policies"
},
"included": [
{
"type": "users"
}
]
}Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info