Webhooks & External Forms

Step 1: Embed Surface Scripts

Add Surface Scripts to your Site

Check out the How to Get Site ID page to get your site ID.

Surface Tag

Add the following script tag inside your <head> tag:

<!-- Start Surface Tag -->

<script 
	src="https://cdn.jsdelivr.net/gh/trysurface/scripts@latest/surface_tag.min.js"  
	site-id="YOUR_SITE_ID"
></script>

<!-- End Surface Tag -->

Using a verified custom domain? Add data-custom-domain="forms.example.com" to the Surface Tag. Follow the custom-domain setup guide before publishing the change.

Surface External Script

Embed the script at the end of the <body> tag:

<script siteId="YOUR_SITE_ID">
  const surfaceExternalForm = new SurfaceExternalForm();
  surfaceExternalForm.attachFormHandlers();
</script>

On this page