---
title: 'Email Ingest'
url: 'https://doc.brix.ch/celum_extensions/email_ingest'
markdown: 'https://doc.brix.ch/celum_extensions/email_ingest.md'
lang: en
date: '2026-10-26'
description: 'Technical documentation for the CELUM Extension "Email Ingest" – Software developed by brix'
taxonomy:
  category:
    - docs
---

[](#) 

  [ Welcome ](https://doc.brix.ch/)     [ CELUM Extensions ](https://doc.brix.ch/celum_extensions)      Email Ingest    

# Email Ingest

![No UI](https://img.shields.io/static/v1?label=UI&message=none&color=inactive)

The Email Ingest plugin allows you to send attachments to a dedicated email account, where they will be detected and uploaded into a specific node (-structure) within CELUM. Processed mails will be marked as read. This may be useful for archiving meeting minutes automatically in CELUM, or (in a more limited fashion) to send photos as attachments to CELUM.

Note: Usually the total size of attachments is capped at ~10MB, depending on the mail server. We'd recommend [Upload Request](https://doc.brix.ch/celum_extensions/upload_request_3) for larger batches, or a [hotfolder](https://doc.brix.ch/celum_extensions/local_hotfolder) for automated scenarios.

#### Table of Contents

- [Properties](#properties)
- [Example](#example)
- [Compatibility Matrix](#compatibility-matrix)
- [Release Notes](#release-notes)

## Properties

To be configured in {home}/appserver/conf/custom.properties

##### emailIngest.license

> type: string, **required: yes**, default: -

The license key for the plugin (product: emailIngest), provided by *brix*.

##### emailIngest.host

> type: String, **required: yes**, default: -

Which mail host to query, e.g. `mail.company.com`

##### emailIngest.port

> type: integer, required: no, default: 995

Which port to use

##### emailIngest.protocol

> type: String, required: no, default: imaps

Which protocol to use, imap(s) is recommended

##### emailIngest.username

> type: String, **required: yes**, default: -

The username to use for authentication

##### emailIngest.password

> type: String, **required: yes**, default: -

The password to use for authentication

##### emailIngest.folder

> type: String, required: no, default: INBOX

Which folder to query for unread messages.

##### emailIngest.targetNodeId

> type: double, **required: yes**, default: -

Where to upload the attachments to. Needs to be permission defining.

##### emailIngest.createSubnodes

> type: boolean, required: no, default: true

Whether to create a subnode per email, named after the subject. Set this to false to simply upload everything into the `targetNodeId`.

##### emailIngest.subnodesWithFrom

> type: boolean, required: no, default: true

Whether to append the sender's address to the name of the subnode. Only applies when `emailIngest.createSubnodes` is true.

##### emailIngest.cronExpression

> type: Quartz-Expression, required: no, default `0 */1 * * * ?` (every minute)

How often to check the mailbox for new emails.

## Example

```
emailIngest.license=********
emailIngest.host=mail.brix.ch
emailIngest.username=ingest
emailIngest.password=********
emailIngest.folder=INBOX
emailIngest.targetNodeId=1337
```

## Compatibility Matrix

| Email Ingest | CELUM (min. version) |
|---|---|
| 1.0.0 | 5.13.4 (tested up to 6.8) |

## Release Notes

##### 1.0.0

> Released 2021-04-27

Initial version

 [ ](https://doc.brix.ch/celum_extensions/azure_custom_tags) [](https://doc.brix.ch/celum_extensions/scim_endpoint)

---

## Navigation

- Parent: [CELUM Extensions](https://doc.brix.ch/celum_extensions.md)
- Previous: [MS Azure Custom Tags](https://doc.brix.ch/celum_extensions/azure_custom_tags.md)
- Next: [SCIM Endpoint](https://doc.brix.ch/celum_extensions/scim_endpoint.md)