Create a contact
A contact is the core record in SWS Agent—every conversation, deal, task, and campaign ultimately ties back to a person or organization stored in Contact Management (/contact-management). Manual create is for one-off leads; use Import contacts when loading lists at scale.
Who can do this
Owners and Admins, and users granted Contacts → Create, can create contacts. Assigning and editing contact information may depend on additional permissions.
Before you begin
- Manage contact settings so Status, Source, and Lifecycle Stage dropdowns are populated
- Custom fields added before you need them on the form
- Integrations connected if you will email or WhatsApp immediately after save
In this guide
A saved contact visible in the All contacts directory, openable on /contact/:contactId, ready for Inbox threads, tasks, deals, and Smart List membership.
Step-by-step procedure
Open Contact Management
- Sidebar → CRM → Contacts (
/contact-management). - Confirm you are on the All contacts tab unless you intentionally create inside a Smart List tab.
- Related routes from the same module:
- Import:
/contact-management/import - All ponds:
/contact-management/available-to-claim
- Import:
Search before create
- Use toolbar search for phone, email, and name.
- Open a possible duplicate instead of creating a second record—duplicate contacts fragment Inbox history and campaign metrics.
Create the contact
- Select Add New Contact on the right toolbar.
- Complete the form:
| Field area | Guidance |
|---|---|
| First Name | Required; Last Name is a separate optional field |
| Phone | Add a phone number if you want to call or message this contact. |
| Add an email address if you want to email this contact. | |
| Company | Use for B2B accounts |
| Lifecycle Stage | Choose the stage that best describes where the contact is in your process. |
| Status | Choose a status for the selected Lifecycle Stage. |
| Source | How they entered—be consistent for reporting |
| Owner / Assignee | Who owns follow-up when shown |
| Custom fields | Any fields defined in settings |
| Tags | Quick labels for filters and Smart Lists |
- Select Create Contact. The new record appears in the directory.
After save — contact detail
Open the newly created row to reach /contact/:contactId; creation itself keeps you on the directory. If no valid email or phone is present, the record displays a warning to add or repair a communication channel.
| Action | Where |
|---|---|
| Log notes | Notes section |
| Send email/WhatsApp | Communication actions on record |
| Create task | Tasks linked to contact |
| Start deal | Deals tab |
| View timeline | Activity / timeline |
| Set reminder | Reminders panel or Reminders module |
Full tour: Use the contact detail page
Verify your work
- The contact appears in All contacts.
- The details you entered appear on the contact record.
Tips
One phone, one email. Search before create every time.
Source discipline. Train reps to pick real sources—not generic buckets—so Reports stay trustworthy.
Star a Smart List tab after saving filter criteria for the same segment you manually add to often.
Troubleshooting
| Required field error | Complete First Name and any other fields marked required by the form | | Status list empty | Configure statuses under Contact settings | | Cannot assign owner | Permission or pond rule—check with Admin | | Duplicate warning | Open existing contact instead of creating a second record | | Custom field missing on form | Create field first, refresh create modal |