Skip to content
D
Documentation

Create a contact

task
7 min readUpdated

Use this page to locate an existing contact or enter a new person's information and connect that person to an account.

Create and locate a contact

A contact is a person record that your organisation can connect to an account. Use the Contacts workflow to locate an existing person or open the new-contact form.

If you need to…Go to
Open the list and locate an existing contactContacts and then Find a contact
Start a new contactEnter contact details
Understand the main contact fieldsUnderstand the contact information
Review or maintain a saved contactContact record
Review the account connected to a contactAccounts
Manage files attached to a saved contactLibraries

Open the Contacts list from the Contacts area. From that list, use New when you have permission to create a contact, or open an existing contact from the list.

Before you start

The Contacts subscription must be included before the contact form is available. Your permission to create a contact controls whether New appears. Prepare the person's identity and the account to which the person belongs before you save.

PrepareWhy it matters
Contacts subscription includedThe Contacts workflow and its form are available.
Permission to create a contactNew is available when the permission allows it.
Contact nameName is required before save.
Related accountAccount is required before save.
Editable formContact Details is available only when the form is not read-only.

The account choices and initial field values depend on the account in use. Select from the account choices shown in Account rather than relying on a value from another account.

Find a contact

The Contacts list is the starting point for locating an existing contact or opening the new-contact flow.

Prerequisites

  • The Contacts subscription is included.
  • You have permission to create a contact if you need New.

Steps

  1. Open the Contacts list.

  2. Read the visible list headers.

    Current columnUse it to read
    TitleThe contact's title.
    NameThe person's name.
    PositionThe person's position.
    DepartmentThe person's department.
    AccountThe related account.
    BranchThe contact's branch.
  3. Choose one route.

    If you need to…Select or do this
    Start a new contactSelect New when your permission allows it and the Contacts subscription is included.
    Locate an existing contactOpen the contact from the list.
The Contacts list with its current columns and list controls

Additional columns can appear according to your selected list layout. Work from the headers visible in your list when those columns differ.

Result: The Contacts list is on screen, and you have either opened the new-contact form or reached the existing contact you need. If you opened the form, continue with Enter contact details.

Understand the contact information

The new-contact form identifies a person and connects that person to an account. Its main fields are Title, Name, Position, Department, and Account.

Main fieldRequired marker on the new-contact formWhat to enter or choose
TitleNoThe person's title.
NameYesThe person's name.
PositionNoThe person's position.
DepartmentNoThe person's department.
AccountYesThe account connected to the person.

The editable form boundary includes Contact Details, which opens optional communication-detail choices. Attachment and Last Modifications belong to a saved contact: they require a saved contact ID and are absent for a new contact.

The new-contact form with its main fields and required markers

Use this field reference when you complete the form in Enter contact details.

Enter contact details

Enter the person's identity and account first. Add only the communication details that apply to the contact.

Prerequisites

  • The new-contact form is open.
  • The form is editable.
  • You know the contact's name and related account.

Steps

  1. Enter the person's title in Title, if applicable.

  2. Enter the person's name in Name.

  3. Enter the person's position in Position, if applicable.

  4. Enter the person's department in Department, if applicable.

  5. Select the related account in Account.

  6. Select Contact Details.

  7. Select each applicable communication choice.

    Contact-detail choiceRule
    PhoneMaximum length 20.
    FaxMaximum length 20.
    MobileMaximum length 20.
    EmailThe value must pass email validation.
    WebsiteEnter the applicable website value.
    Online SupportEnter the applicable online-support value.
    CommentsEnter the applicable comments.
  8. Enter the value in each contact-detail field you selected.

The seven choices opened from Contact Details

Result: The contact's main information is entered, and the applicable communication-detail fields are selected and available for values.

Save the contact

Save only after Name and Account are complete and the form passes its validation checks.

Prerequisites

  • The form is editable.
  • Name has a value.
  • Account has a selected account.
    • The mandatory-field check passes.
  • The data validator is valid.

Steps

  1. Start the form exit flow after entering the contact information.

  2. In the exit-form confirmation popup, choose the outcome that applies.

    If you want to…Select
    Commit the contactSave
    Leave without committing the changesDon't Save
  3. After saving, check for Contact saved successfully.

Result: A successful save reports Contact saved successfully and opens the saved contact record. Review the applicable surface variation, then continue with After saving.

Handle contact variations

The contact surface changes according to subscription, permission, editability, and whether the contact already has an identifier.

VariationWhat changes
New-contact accessNew requires permission to create a contact and an included Contacts subscription.
Read-only formContact Details is available only when the form is not read-only and the subscription is included.
Saved contactAttachment and Last Modifications require a saved contact ID and a non-popup form.
Duplicate-name checkThe form checks whether the contact name matches an existing contact.
Account lookupThe choices shown depend on account data for the account in use; local-branch records are filtered.

If a variation prevents saving, use When contact saving goes wrong. If saving succeeds, continue with After saving.

Result: You know which contact surface applies and where to go when the contact is saved or cannot be saved.

When contact saving goes wrong

Use the message on screen to choose the correction.

What you seeWhat to correct
This Field Is RequiredEnter a value in the field marked as required.
Just '_'‘-''.' And '&' Characters AcceptedCorrect Name to use the accepted name characters.
Account field is mandatorySelect an account in Account.
Please Solve the Following Issues :Resolve the listed validation issues before saving.
You already have a contact with this nameUse a contact name that does not duplicate an existing contact.
Error: This Contact Name Already ExistsChange Name and try the save again.
Error: Server ErrorResolve the server problem before treating the contact as saved.
Email is invalidCorrect the value in Email.
At least One Contact Detail is RequiredSelect at least one choice from Contact Details.
At least One Contact Detail Must Have a ValueEnter a value in at least one selected contact-detail field.

The following messages belong to related surfaces rather than this create-and-locate task:

MessageRelated surface
You already have account with this nameAccount popup.
Name is requiredNew-account popup.
This field is requiredNew-account or vendor popup.
Forbidden characters detected. Please remove them and try again.Contacts list action.
Error.. client not saved yetAccount popup.
Error.. vendor not saved yetVendor popup.
Your request was completed successfullyContact attachments or file library.

After correcting the displayed issue, return to Save the contact. If the save succeeds, continue with After saving.

Result: The displayed issue is corrected, or the save problem is identified before you continue.

After saving

A saved contact has a contact ID that enables its saved-record surfaces. After saving, continue to the saved contact record.

Prerequisites

  • The contact has been saved and has a contact ID.
  • The contact is open outside a popup.

Steps

  1. Open the saved contact record.

  2. Select the saved-contact area that applies.

    If you want to…Select
    Continue with the saved contact's attachmentsAttachment
    Continue with the saved contact's change historyLast Modifications

Use Libraries for attachment and file-library management. Use Contact record for saved contact record maintenance.

Result: A saved contact exposes Attachment and Last Modifications when its ID is present and the record is not in a popup. Related attachment work continues in Libraries, and saved contact maintenance continues in Contact record.

Was this page helpful?

Need help using the product?

Create a contact — PAMS Fresh Generation