# JavaScript

For any integration, there are two pieces of JavaScript that you need: our JavaScript library and some configuration code. See the tutorial for more details on how to add this code to the page containing your address form.

# JavaScript Library

Link to the JavaScript library:

<script src="https://cc-cdn.com/generic/scripts/v1/cc_c2a.min.js"></script>

There are two options for adding the JavaScript library:

Firstly, we host the final, compacted code on a CDN. This means that to add the JavaScript library to your page, you simply need to include this link. We recommend that you use this option, as you will automatically receive updates and bug fixes.

Alternatively, you can download the JavaScript and host it on your own server. You can download the package here from Github.

# Setup

The first step is to initialize the library and complete a setup, so that you can add forms to it.

window.cc_c2a = new clickToAddress({
	accessToken: 'xxxxx-xxxxx-xxxxx-xxxxx' // Replace this with your access token
})

TIP

This call can only be performed once on every page; please call it only once during page load.

# Add Email Validation

Adding email validation is now quite simple, simply let the library know that there's a new form to be validated.

window.cc_c2a.addEmailVerify({
	email: '#email',
	allow_high_risk: false
});
Key Type Required? Description
email string Required The field that you want to validate. Accepts a valid query selector, the id of a field or an HTML element.
allow_high_risk boolean Optional Default: false.
Switching this feature to false will make the library reject disposable email addresses.

WARNING

Some of the largest email provides have malicious actors who run email services on domains with typos. For example, for Gmail, gmil.com and gmai.com run services. (probably for scamming purposes) In general, we suggest leaving the allow_high_risk on false.

Last Updated: 9/8/2020, 9:11:15 AM