Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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 .

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.

    FieldValue
    Typerecord
    Operationcreate
    Admin overridesSelected
    Namesys_email
    Requires roleemail_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.