> For the complete documentation index, see [llms.txt](https://docs.enate.net/whats-new/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enate.net/whats-new/older-versions/changes-overview-older-versions/2022.3-changes-overview/auto-creating-external-contacts.md).

# Auto-creating External Contacts

It's now possible to set the system to automatically create a new external Contact record when incoming emails arrive which contain new email addresses.

The new setting to allow this is found in Builder's [General Settings](https://docs.enate.net/enate-help/builder/builder-2021.1/system-wide-settings/general-settings#enable-automatic-contact-creation) section, and is set to ON by default, i.e. to enable automatic creation of contacts from emails.

![](https://1296463846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8xJkS0SKlesb8bmVBtGc%2Fuploads%2FHq0YHb1Yi5K9ASw26ruw%2Fimage.png?alt=media\&token=633ac76e-705c-4f8f-b2b9-e015bf9131b1)

Note that when such a new contact record is auto-created, the company it gets linked to will depend on the contact scope setting in place: If it's set to 'Global', or 'Global and Local', the auto-created contact will have a Global scope, i.e. not linked to any specific company.  If it is set to 'Local', the auto-created contact will be created under the company that the related Work item exists under.

![](https://1296463846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8xJkS0SKlesb8bmVBtGc%2Fuploads%2FGVcVulr5so2mAIX5nG4W%2Fimage.png?alt=media\&token=d7050908-a9d3-481a-ba94-607fb31efb2d)

The system will auto-populate the first name and last name of the contact based on the email display name. More specifics on this:&#x20;

* If there is a space in the email display name, anything before the first space will be used as the contact's first name and anything after the last space will be used as their last name. For example, if the email display name is 'John Smith' then the contact's first name will be auto-filled as 'John' and their last name will be auto-filled as 'Smith'.&#x20;
* If there is a comma in the email display name, anything before the first comma will be used as the contact's last name and anything after the comma but before the space will be used as their first name. For example, if the email display name is 'Smith, John' then the contact's last name will be auto-filled as 'Smith' and their first name will be auto-filled as 'John'.
* If the system can't auto-fill the first name and last name with confidence, then the contact will be auto-created without a first and last name and the user will be prompted to fill this themselves when they submit the work item.

Additionally, a new standard column has been added to the Contact Management Page called 'Auto-Created' that lets users see which of their external contacts have been created automatically, and which have been created manually.

![](https://1296463846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8xJkS0SKlesb8bmVBtGc%2Fuploads%2FAkn5IjnJanMwLonumfao%2Fimage.png?alt=media\&token=bf4c486c-b6dc-4155-989d-8dceb1e80a3d)

{% hint style="info" %}
Please note that once a contact that has been auto-created has had edits made to it, it will no longer display as an auto-created contact in the 'Auto Created' column of the Contact Management Page.
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.enate.net/whats-new/older-versions/changes-overview-older-versions/2022.3-changes-overview/auto-creating-external-contacts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
