Grant access to the Email API
task australia Updated Sep 10, 2026 1 min read grant-access-to-email-api.md
To grant non-admin users access to the Email API, administrators must create an access control and assign a special role.
Before you begin
Role required: admin
About this task
For additional details, see Email API .
Procedure
-
Elevate privileges to security_admin.
-
Navigate to System Security > Access Control (ACL).
-
Click New.
-
Create an access control for the Email [sys_email] table.
Field Value Type record Operation create Admin overrides Selected Name sys_email Requires role email_api_send -
Assign the email_api_send role to the non-admin user.
-
Verify the non-admin user either has read access to all records in the notification target table or has read access to a specific record in the table.
For example, to work with incident notifications the non-admin user needs access to the Incident table. You can provide record access by:
- Granting the user an appropriate role, such as the itil role.
- Selecting a specific incident that was opened on behalf of the user.
52 lines · 1.7 KB
---
title: Grant access to the Email API
description: To grant non-admin users access to the Email API, administrators must create an access control and assign a special role.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/platform-administration/grant-access-to-email-api.html
release: australia
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Configure, Email Administration, Notifications, Configure core features, Administer the ServiceNow AI Platform]
---
# Grant access to the Email API
To grant non-admin users access to the Email API, administrators must create an access control and assign a special role.
## Before you begin
Role required: admin
## About this task
For additional details, see [Email API](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/email-api.md) .
## Procedure
1. Elevate privileges to security\_admin.
2. Navigate to **System Security** > **Access Control \(ACL\)**.
3. Click **New**.
4. Create an access control for the Email \[sys\_email\] table.
|Field|Value|
|-----|-----|
|Type|record|
|Operation|create|
|Admin overrides|Selected|
|Name|sys\_email|
|Requires role|email\_api\_send|
5. Assign the email\_api\_send role to the non-admin user.
6. Verify the non-admin user either has read access to all records in the notification target table or has read access to a specific record in the table.
For example, to work with incident notifications the non-admin user needs access to the Incident table. You can provide record access by:
- Granting the user an appropriate role, such as the itil role.
- Selecting a specific incident that was opened on behalf of the user.
| title | Grant access to the Email API |
| description | To grant non-admin users access to the Email API, administrators must create an access control and assign a special role. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/platform-administration/grant-access-to-email-api.html |
| release | australia |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | ConfigureEmail AdministrationNotificationsConfigure core featuresAdminister the ServiceNow AI Platform |