# Completion Alerts

## 📧 **What are completion alerts ?**

Completion alerts are a great way to get or send email based notifications once a user has finished a survey.\
\
Use cases can range from receiving a list of respondent's answers to more complex scenario where we can create templates with file attachments and trigger alerts only if the respondents have answered specific answers.

## 🔅 Completion alert properties

* **`Name`** of the person sending the email 
* **`From email`** email of the sender 
* **`To email`** email of the recipient of the alert message. You can send an alert to multiple recipients using the ; between each recipient. 
* **`Subject`** is the subject of the email alert.
* **`Add attachments`** you can add any number of files.
* **`Attach respondent answers`** attach respondent answers as PDF or Word to the completion alert email .
* **`Attach restricted answers`** attach any restricted answer as a PGP file.

{% hint style="info" %}
🧙 You can [pipe](/form-management/form-designer/piping/text-data-piping.md) into any of the properties above respondent answers or [data attribute](/form-management/security/data-attributes.md) values from security items. As such you could ask the respondent for his email during the survey and [pipe](/form-management/form-designer/piping/text-data-piping.md) that email in your completion alert task to send him an email. 
{% endhint %}

## 📝Completion alert message

The [rich text editor](/form-management/form-designer/rich-text-editor.md) let you add a custom message that will be send in the body of the completion alert email.

Using the pipe icon you can pipe into your message special pipe tags that will be replaced at runtime by respondent answers.

![](/files/-MBJuZwofy6D9w2u4SEt)

## 📋 Completion alert message pipe tags

Beside being able to [pipe](/form-management/form-designer/piping/text-data-piping.md) any respondent answers or [data attribute](/form-management/security/data-attributes.md) values you can also use following special pipe tags.

* **`{{surveyTitle}}`** will be replaced by the actual survey title
* **`{{respondentInfos}}`** will be replaced by the respondent details

![](/files/-MBK40fN1cnKiPfkt5oc)

* **`{{respondentAnswers}}`** will be replaced by the respondent answers. 

![](/files/-MQLt1_EB5X9CWYQjeci)

* **`{{respondentFullAnswers}}`** will be replaced by the full list of answers including the answers that were not answered by the respondent.

![](/files/-MBK4JwC5hq4n5PLdYUx)

* **`{{editActionLink}}`** will be replaced by a dynamically generated [action link](/form-management/respondents-management/actions-links.md) to access the respondent answers to update them.
* **`{{editNewActionLink}}`** will be replaced by a dynamically generated [action link](/form-management/respondents-management/actions-links.md) to access the respondent answers to create a new respondent based on the posted answers.
* **`{{reportActionLink}}`** will be replaced by a dynamically generated [action link](/form-management/respondents-management/actions-links.md) to access the respondent answers to as a read only report.


---

# Agent Instructions: 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.ngsurvey.com/form-management/tasks/task-items/completion-alert.md?ask=<question>
```

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.