Multiple Contact Types and Subcontractor Job History (May 4th, 2023)

Today's release sees the following additions to the ServiceTrade Web App:

• The ability to select multiple contact types for a contact.
• Visibility on the Job History when Subcontractors are scheduled or assigned to the Job.

Select Multiple Contact Types for a Contact

Now you can select multiple Contact Types for a contact on the Contacts List Page.

Follow the instructions below to update Contact Type on the Contact List Page:

1. On the Navigation Bar, hover over Customers.
2. Click Contacts.
3. Search and select the contact.
4. Click the Types field.
5. Search and select the Contact Type. Repeat as many times as needed.
   
6. Click Update Contact.

Follow the instructions below to update Contact Types on the Company and Location Page:

1. To begin, navigate to the Company or Location to which you want to edit a Contact.
2. Click the Contacts icon next to the name of the entity.
   
3. Click the pencil icon next to the contact you want to edit.
4. Click the Types field.
5. Search and select the Contact Type. Repeat as many times as needed.
   
6. Click Update Contact.

Important Notes:

• Only the first contact type selected will be visible in the Type column on the Contacts List Page and on the Location or Company Page.
  
• Contact List Page
  
  

Contact Type API Changes

IMPORTANT: This change includes a corresponding change to the Contact API endpoint. With this release, the type field on the contact object (representing a single contact type) is deprecated in favor of a types array (representing multiple contact types).

On GET, the contact endpoint will return both type and types properties.  The value of the type property will be the alphabetically first member of the types array; for example:

{
  ...
  type: 'management',
  types: ['scheduling', 'management']
  ...
}

On POST and PUT, the contact endpoint will accept both type and types properties.

• If only type is provided, the types array will be populated with a single member, which is the value provided for type.
  • On PUT, the existing values of the types array will be completely replaced by the single value provided for type.
• If only types is provided, the types array will be populated as specified, and type will be populated with the alphabetically first member of types.
• If both type and types are provided, the type property will be ignored, and both the type and types values will both be populated as if only the types property had been provided.

Job History Shows Subcontractor Activity

When a Subcontractor is assigned or scheduled to a Job, those actions will be recorded in the Job History. 

See the below example: