Troubleshooting "Server Error" When Creating or Editing Email Ingestion Integrations

This article explains how to troubleshoot and resolve a generic "Server Error" that may appear when you create or edit Email Ingestion integrations, including Everbridge Open Email Ingestion. Follow the steps in order to rule out the most common causes before contacting support.

Symptoms

• You see a generic "Server Error" message when creating a new Email Ingestion integration.
• You see the same error when editing an existing Email Ingestion integration.
• The error occurs in the Manager Portal while working with Everbridge Open Email Ingestion or other Email Ingestion integrations.

Possible causes

• Your default role and permissions in the organization where the email ingestion is configured are not set correctly.
• Your browser session is stale or affected by cached data.
• You have multiple Manager Portal tabs open (for example, account-level and organization-level views at the same time).
• The issue is specific to your computer, browser, or local environment.

Resolution steps

Step 1: Confirm your default role and permissions

The most common cause of this error is a permissions context issue related to your default role in the organization where the email ingestion lives.

1. Check your default role in the specific organization that owns the Email Ingestion integration.
2. Make sure your default role in that organization is Organization Admin or another role that includes Email Ingestion edit privileges.
3. If you have multiple roles across different organizations, confirm that a default role is explicitly set for the organization that owns the ingestion.
4. If no default role is set in that organization, have an administrator assign a default Org Admin role there and save the changes.
5. After updating the default role, sign out of the Manager Portal.
6. Sign back in to refresh your permissions.
7. Try creating or editing the Email Ingestion integration again.

Step 2: Refresh your browser session

A stale browser session or cached data can also trigger a server error while saving or editing integrations.

1. Clear your browser cache and cookies.
2. Open a new private/incognito window.
3. Sign back into the Manager Portal.
4. Try the same create or edit action for the Email Ingestion integration.

Step 3: Close extra Manager Portal tabs

Having multiple Manager Portal tabs open, especially a mix of account-level and organization-level views, can cause internal errors when saving changes.

1. Close any extra Manager Portal tabs in your browser.
2. Keep a single tab open.
3. Navigate in that tab to the Email Ingestion integration you want to create or edit.
4. Retry the operation.

Step 4: Try a different computer or browser

To check whether the problem is local to your environment, test from another system.

1. If available, use a different computer and sign in with the same user.
2. Optionally, try a different supported browser on that computer.
3. Attempt to create or edit the same Email Ingestion integration and see if the server error still occurs.

When to contact support

If the "Server Error" persists after you:

• Confirmed and corrected your default role in the relevant organization,
• Signed out and back in, and refreshed your browser cache,
• Closed extra Manager Portal tabs, and
• Tested from a different computer,

then the issue is likely account- or configuration-specific and will require further investigation by support.

What to provide to support

When you contact support, it is helpful to provide:

• A brief description of the steps you took just before the error appeared.
• Confirmation of your role and the organization where the ingestion is configured.
• A HAR file and a screen recording that clearly show the error occurring while you attempt to edit or create the Email Ingestion integration.