CanopyConnect

.create(options)

Returns a Handler

Creates a SDK Handler instance for your link.

Kind: static method of CanopyConnect

Param	Type	Description
options	Object	SDK Handler options.
options.publicAlias	String	The public alias of the link you would like to use. Each link has a unique public alias. You can view all your links on the Links Page. The public alias is what follows after the `/c/`in your link's url. Example: the public alias for `https://app.usecanopy.com/c/demo`is `demo`.
options.modal	Boolean	Default=true. Whether Canopy Connect should be in a modal. If `false`, `options.mount` will be used
options.mount	String/Element/null	Can be used when `options.modal=false`, this specifies where Canopy Connect should be mounted to and will mount there immediately when `.create()` is called. Alternatively you can use `.mount()` to mount after `.create()` is called.
[options.hideCloseButton]	Boolean	Used to control the close button visibility
[options.pullMetaData]	Object	Arbitrary JSON-serializable data. The API returns this data in Pull.meta_data
[options.prefillAndSkip]	Object	Arbitrary JSON-serializable data. Speed up the user experience and improve conversion by supplying inputs that you already have values for. The Canopy Connect widget will skip asking the end user to supply provided inputs. Eg. Supply an object like the one below to speed up Farmers Auto ID Card Search for your users. This will skip asking the user to choose between entering their policy number and personal information, and supply their name, zip code and date of birth. When the end user selects Farmers Auto ID Card Search, they won't be asked to supply any of those inputs. `prefillAndSkip = { "firstName": "Clark", "lastName": "Kent", "zipCode": "90210", "dateOfBirth": "01/01/1990", "policyNumberOrInfo": "info" }`
[options.consentToken]	String	A token retrieved by pre-collecting consent to skip the first screen in the widget. Reference the Consent API for more information.
[options.reconnectToken]	String	When dropping the user into the Monitoring reconnect flow provide a `reconnectToken` instead of `consentToken`. See How to use Monitoring.
[options.onAuthenticationSuccess]	Callback	Triggered when the user successfully authenticates with their insurance provider. Reference the 'authenticationSuccess' event for data parameters.
[options.onSectionViewed]	Callback	Triggered when the user views a section. Will trigger when viewed again. Reference the sectionViewed event for parameters.
[options.onUserAction]	Callback	Triggered when user completes certain actions. Reference the onUserAction event for parameters.
[options.onSelectCustomInsuranceProvider]	Callback	Triggered when the user selects "Provide policy manually" while searching for their carrier. Contact support@usecanopy.com to enable this feature. Reference the 'selectCustomInsuranceProvider' event for data parameters.
[options.onExit]	Callback	Triggered when the user exits the Canopy Connect SDK modal. Reference the 'exit' event for data parameters.
[options.onError]	Callback	Triggered on non-terminal errors.
[options.onDestroy]	Callback	Triggered when the Handler is destroyed after `Handler.destroy()` is called.

Handler

Instance of EventEmitter

.close()

Closes the Canopy Connect SDK modal.

Kind: instance method of Handler

.destroy()

Removes the SDK from the application and triggers the destroy event.

Kind: instance method of Handler

.mount(selectorOrElement)

Can be used when options.modal=false. Mounts the SDK directly to the selector or Element.

Kind: instance method of Handler

.on('authenticationSuccess')

Triggered when the user successfully authenticates with their insurance provider.

Kind: instance method of EventEmitter

Param	Type	Description
data	Object	Event data.
data.pull	Object	The resulting Pull that was successfully authenticated.
data.pull.pull_id	String	The ID of the Pull, use this to wait for the Pull's webhooks.
data.pull.metadata	Object/null	The metadata of the Pull, will match what was passed in via `pullMetaData` and/or `cc-meta` params.

.on('sectionViewed')

Triggered when a section is viewed. Triggers again if section is viewed again.

Kind: instance method of EventEmitter

Param	Type	Description
data	Object
[data.section]	String	Possible values: `INTRO`, `LOGIN`, `SUCCESS`, `DRIVERS`, `DOC_UPLOAD`, `CONTACT_INFO`, `SELECT_POLICIES`, `DEMOGRAPHICS`, `CUSTOM`, `TEXT_DISPLAY`, `VEHICLES`, `DWELLING`, `INSURANCE_TYPES`, `INSURER_LIST`, `LOGIN_MFA_OPTIONS`, `LOGIN_MFA_CREDS`, `LOGIN_SUBMITTING_CREDS`

.on('userAction')

Triggered when user completes certain actions.

Param	Type	Description
data	Object	Data associated with this user action
[data.action]	String	Type of action taken. Possible values: `CONSENT_SUBMITTED`, `CREDS_SUBMITTED`, `MFA_SUBMITTED`, `INSURER_SELECTED`, `DOCUMENTS_SUBMITTED`
[data.data]	Object	Additional data about the action taken. Currently only sends `insurance_provider_name` when `action` is `INSURER_SELECTED`.
[data.pull]	Object/null	Pull object
[data.pull.pull_id]	String	The ID of the associated pull.
[data.pull.metadata]	Object/null	The metadata of the Pull, will match what was passed in via `pullMetaData` and/or `cc-meta` params.

.on('destroy')

Triggered when the Handler is destroyed after Handler.destroy() is called.

Kind: instance method of EventEmitter

.on('exit')

Triggered when the user exits the Canopy Connect SDK modal.

Example: handler.on('exit', (err: any, data: any) => {});

Kind: instance method of EventEmitter

Param	Type	Description
err	Object/null	Exists if the user exited before successfully authenticating. Contains a error_code which is the step the user exited on.
[err.error_code]	String	Possible values: `NOT_AUTHENTICATED`, `INTERNAL_ERROR`, `PROVIDER_ERROR`, `INSUFFICIENT_CREDENTIALS`, `IDENTITY_VERIFICATION_OPTIONS`, `IDENTITY_VERIFICATION`
data	Object/null	Exists if the user consented and created a pull.
[data.pull]	Object	The Pull that was created. If no `data.err` exists, this Pull was successfully authenticated.
[data.pull.pull_id]	String	The ID of the Pull that was created.
[data.pull.metadata]	Object/null	The metadata of the Pull, will match what was passed in via `pullMetaData` and/or `cc-meta` params.

.on('selectCustomInsuranceProvider')

Triggered when the user selects "Provide policy manually" while searching for their carrier. Contact support@usecanopy.com to enable this feature.

Kind: instance method of EventEmitter

Param	Type	Description
data	Object	Event data.
data.providerName	String	Insurance provider name entered by the user when they clicked "Provide policy manually"

.open()

Opens the Canopy Connect SDK modal.

Kind: instance method of Handler