> For the complete documentation index, see [llms.txt](https://docs.alemba.com/asm-eos-10.5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alemba.com/asm-eos-10.5/setup-and-configure-asm/setting-up-your-system/setup-email/setting-up-incoming-and-outgoing-email/incoming-email-via-api.md).
# Incoming Email via API
New for 10.5, a new “Alemba API” protocol is available to select when creating a new incoming email server:
A new field called “Email Server Id” will appear which will contain a value. This value is needed when creating requests to add emails via the API.
The remailing fields are the standard incoming email fields.
Logic App Configuration
1. Create Logic App with the “When a new email arrives (V3)” Office 365 Outlook trigger. The “Include Attachments” parameters needs to be enabled.
2. Add an “Initialize variable” action where the variable name is Attachments and the type is array:
3. Add an “Initialize variable” action where the variable name is BodyHtml and the type is string:
4. Add a “For each” action which will loop through the Attachments from the trigger and will append the Attachments Content, Attachments Name and Attachments Is Inline values to the attachments array:
5. Add a “Condition” action within the “for each” action that will check whether the Attachments Is Inline value is equal to true:
6. Go into the settings of the “for each” action and set the concurrency control limit to 1:
7. Under the “True” side of the condition add the following actions:
* Link to the ReplaceInlineImages Azure function
* This action will pass the attachment name, ref and the HTML version of the description to the ReplaceInlineImages functions and will return the updated HTML version of the description, to include the inline image.
* Before adding this action, you will need to create a function app and the function itself. An example of this function app can be found in the INFORMCOMMS directory, under the name ‘email-func-inline-attachments-scottd’.
* When creating the function app, ensure that the Runtime stack is set to ‘Node.js’ and the Version is set to ’12 LTS’.
* The function needs to be deployed locally using VS Code. You can find details about doing this if you go to functions and click on Add. Select VS Code as the Development environment. It will give instructions on how to configure VS Code to deploy to Azure Functions.
* Extract this zip file and open it up in VS Code.
* In the explorer right click on ReplaceInlineImages and select ‘Deploy to Function App…’.
* Select the relevant subscription .
* Select the relevant function app.
* Then click deploy.
* Once completed you can see if it was successful by accessing the function app and see if the ReplaceInlineImages function exists. It will not let you see or modify the code within the Azure Portal, so if any modifications are needed, they will need to be done in VS Code and redeployed.
* Parse the ReplaceInlineImages Json Response
* Set the BodyHtml variable with the DescriptionHtml
## Post to the Alemba API
1. Outside of the “for each” loop add a new “Http” action that will post the data to the Alemba API. You will need to add any necessary authentication. The endpoint url will follow this format: https\://{Server Endpoint}/{System Name}/alemba.api/api/v2/email-incoming/ . The “EmailServerId" parameter is the “Email Server Id” value from the email server settings in ASM.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.alemba.com/asm-eos-10.5/setup-and-configure-asm/setting-up-your-system/setup-email/setting-up-incoming-and-outgoing-email/incoming-email-via-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.