Stay organized with collections
Save and categorize content based on your preferences.
This page explains how to modify an existing reCAPTCHA integration to use
reCAPTCHA features, such as Multi-factor
authentication (MFA) and Password defense after migrating from
reCAPTCHA Classic. Modifying an existing reCAPTCHA
integration involves instrumenting the web pages and migrating the backend calls.
To use reCAPTCHA features, you must migrate your backend calls to
the new endpoints and set up authentication:
Replace backend calls to https://www.google.com/recaptcha/api/siteverify
with equivalent calls to recaptchaenterprise.googleapis.com. For the complete
URL and the POST data format, see Create an assessment for your website.
Set up authentication to reCAPTCHA.
The authentication method you choose depends on the environment where
reCAPTCHA is set up. The following table helps you choose the
appropriate authentication method and the supported interface to set up
authentication:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Use reCAPTCHA features after migration\n\nThis page explains how to modify an existing reCAPTCHA integration to use\nreCAPTCHA features, such as Multi-factor\nauthentication (MFA) and Password defense after migrating from\nreCAPTCHA Classic. Modifying an existing reCAPTCHA\nintegration involves instrumenting the web pages and migrating the backend calls.\n\nBefore you begin\n----------------\n\n[Migrate to reCAPTCHA](/recaptcha/docs/migrate-recaptcha).\n\nInstrument the web pages\n------------------------\n\nTo instrument the web pages with the reCAPTCHA scripts and\ncalls, do the following:\n\n1. Verify that you have the following script included in your web pages: `https://www.google.com/recaptcha/api.js`.\n2. In your web pages, replace `https://www.google.com/recaptcha/api.js`\n with `https://www.google.com/recaptcha/enterprise.js`.\n\n | **Note:** If your web pages have the `https://www.recaptcha.net/recaptcha/api.js` script, then replace it with `https://www.recaptcha.net/recaptcha/enterprise.js`.\n3. If you programmatically invoke the API, then replace the following calls:\n\n - `grecaptcha.execute()` -\\\u003e `grecaptcha.enterprise.execute()`\n - `grecaptcha.getResponse()` -\\\u003e `grecaptcha.enterprise.getResponse()`\n - `grecaptcha.ready()` -\\\u003e `grecaptcha.enterprise.ready()`\n - `grecaptcha.render()` -\\\u003e `grecaptcha.enterprise.render()`\n - `grecaptcha.reset()` -\\\u003e `grecaptcha.enterprise.reset()`\n\nMigrate the backend calls\n-------------------------\n\nTo use reCAPTCHA features, you must migrate your backend calls to\nthe new endpoints and set up authentication:\n\n1. Replace backend calls to `https://www.google.com/recaptcha/api/siteverify`\n with equivalent calls to `recaptchaenterprise.googleapis.com`. For the complete\n URL and the POST data format, see [Create an assessment for your website](/recaptcha/docs/create-assessment-website).\n\n2.\n\n Set up authentication to reCAPTCHA.\n\n The authentication method you choose depends on the environment where\n reCAPTCHA is set up. The following table helps you choose the\n appropriate authentication method and the supported interface to set up\n authentication:\n\n \u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Create an assessment for your website](/recaptcha/docs/create-assessment-website)"]]
