Components of Classic Consent in Approved Email
Classic consent in Approved Email ensures that end users are compliant with local regulations requiring certain levels of consent be obtained before emails are sent to an account.
Each account has some control over what emails are sent to them. Vault CRM's flexible consent model supports a variety of opt types and ensures that opt preferences of an account are respected when sending emails, including designating an account as never being allowed to receive emails.
Classic consent in Approved Email consists of three primary components:
- Consent Type
- Consent Records
- Consent Validation
Who can use this feature?
- Browser, iPad, iPhone Users
- Users require an Approved Email license
- End Users

Consent Types
There are three types of consent in Approved Email:
- Opt-in Required – An opt-in record is required to send email
- Opt-in Not Required – An opt-in record is not required to send email
- Never Email – Emails cannot be sent to the account and opt-in cannot be recorded (this option is only available when set on an existing account)
Every account can have a unique consent type, allowing a single Vault to apply different consent types to different accounts.
Defining an Account's Consent Type
Consent types can be defined at two levels to grant varying levels of control over an individual account's consent type:
-
The Approved Email Opt-in Required Approved Email setting – This check box setting enables admins to set a default consent type value for all accounts.
- When this check box is selected, the consent type is Opt-in Required
- When this check box is not selected, the consent type is Opt-in Not Required
This value can be overridden on an individual account using the approved_email_opt_type__v picklist on the account_v object.
- The approved_email_opt_type__v field on the account_v object – When this picklist is NULL, the account inherits the consent type from the Approved Email Opt-In Required Approved Email setting. When populated with one of the following values, this picklist overrides the setting, enabling more granular control over an account's consent type:
- explicit_opt_in__v – Sets the Consent Type to Opt-in Required
- implicit_opt_in__v – Sets the Consent Type to Opt-in Not Required
- never__v – Sets the Consent Type to Never Email
For example, the Multichannel Explicit Opt In Approved Email setting is selected. An HCP account has approved_email_opt_type__v=NULL, so his inherited consent type is Opt-in Required. Another HCP account has approved_email_opt_type__v=implicit_opt_in__v. This picklist overrides the setting, so his consent type is Opt-in Not Required.

Consent Records
Consent records are stored as approved_email__v object type Multichannel_Consent__v records and represent a specific opt choice made by an account. Consent records are used during the validation phase to check if the proper consent exists. Consent records contain the following information:
- account__v – References the account associated with this consent record
- capture_datetime__v – The capture datetime
- channel_value__v – In approved_email__v type records, this field references the associated email address
- opt_type__v – Represents the captured opt preference and can be one of the following values:
opt_in__v – Emails for all products can be sent to this account and email address pair. Created opt-in records never expire and immediately expire all opt-out multichannel_consent__v records referencing the same account and email address.
If an account has more than one email address, one opt-in record per email address is required prior to sending email for each address.
- opt_out__v – Opt-out type consent records also reference a specific product. Emails cannot be sent to this account, email address, and product triplet.
- product__v – Only populates when opt_type__v=opt_out__v. References the product associated with the opt-out consent record.
- detail_group__v – Only populates when opt_type__v=opt_out__v and when using Detail Groups with Products
- optout_event_type__v – This picklist only populates if opt_type__v=opt_out__v and indicates the opt-out event that caused the consent record to be created:
- unsubscribed__v – The recipient selected an Unsubscribe link within the email
- consent_capture__v – The recipient opted out of emails via Consent Capture
Pre-existing content preferences can be loaded from external systems into multichannel_consent__v records.
Data Loading Consent Records
The multichannel_consent__v object can be populated using a data loader or other integrations. Each multichannel_consent__v record requires the following values:
- object_type__v – Must be approved_email__v
- account__v
- capture_datetime__v
- channel_value__v – In approved_email__v type records, this field references the associated email address
- opt_type__v – Can be either opt_in__v or opt_out__v
- optout_event_type__v – Only required when opt_type__v is opt_out__v
Examples of Consent Records
For example, and HCP opts in to receiving emails sent to exampleaddress@gmail.com. A multichannel_consent__v record with a object type of approved_email__v is created with the following fields:
- account__v – References the HCP's account
- capture_datetime__v – The datetime when the HCP consented to receive emails
- channel_value__v – exampleaddress@gmail.com
- opt_type__v – opt_in__v
- optout_event_type__v – The HCP did not opt out of emails, so this picklist is blank
Emails for all products can now be sent to the HCP at exampleaddress@gmail.com.
In another example, the HCP selects the Unsubscribe link in an email associated with Cholecap sent to his email address exampleaddress@gmail.com. A multichannel_consent__v record with a object type of approved_email__v is created with the following fields:
- account__v – References the HCP's account
- capture_datetime__v – The datetime when the HCP submitted the unsubscribe request
- channel_value__v – exampleaddress@gmail.com
- opt_type__v – opt_out__v
- optout_event_type__v – unsubscribed__v
- product__v – Cholecap
Validation prevents all Cholecap emails sent to the HCP using exampleaddress@gmail.com from sending until an end user captures opt-in consent from the HCP. Emails about other products can still be sent to exampleaddress@gmail.com.
Consent Validation for

Consent is validated whenever an end user tries to send an Approved Email. Validation looks at both the consent type of the recipients as well as any consent records associated with the account. Validation occurs in the following steps:
-
Check the consent type of the account. This is determined by the approved_email_opt_type__v picklist on the account. If the picklist is NULL, the consent type is determined by the Multichannel Explicit Opt In Approved Email setting:
- Consent type is Opt-in Required – Validation looks for any active opt-in multichannel_consent__v record associated with both the account and the email address.
- If no opt-in record exists, end users are prevented from sending the email and are prompted to capture opt-in consent.
- If a valid opt-in record exists, validation proceeds to Step 2
- Consent type is Opt-in Not Required – Validation proceeds to Step 2
- Consent type is Never Email – End users are prevented from sending the email
-
Check for any active opt-out multichannel_consent__v records associated with the account, email address, and product.
- If an active opt-out record exists, end users are prevented from sending the email and are prompted to capture opt-in consent.
If these two steps are completed without error, the end user is able to send the email.