Sign-up form

You can create newsletter sign-up in a few minutes with SpreadAPI. In this tutorial we will create a simple sign-up form with only an email field.

First, create a Google Sheet like the one below. It's just a single sheet called emails with a single column email.

Next, follow the setup instructions to configure API for your spreadsheet. While configuring authentication add the following line to the script so that everybody can add an entry to your sheet.

User("anonymous", UNSAFE(""), { emails: POST });

Now you can now create HTML form on your site. The code below is a good starting point. I added a nice confirmation message shown after signing up.

<!-- I use Bulma CSS framework below. -->
<!-- Visit to learn more -->

<!-- The form -->
<form id="newsletter-form">
    <div class="columns is-multiline">
        <div class="column is-6">
            <input class="input is-medium is-fullwidth" type="email" id="email" placeholder="Enter your Email">
        <div class="column is-6">
            <button class="button is-medium is-primary is-fullwidth is-clear" id="sign-up">Sign up</button>

<!-- A dialog shown after successfully signing-up -->
<div id="subscription-success-modal" class="modal">
    <div class="modal-background"></div>
    <div class="modal-content">
      <div class="box is-clearfix">
            You've been added to the SpreadAPI subscription list!
          <button class="button is-primary is-pulled-right" id="modal-ok-button">OK</button>
    <button class="modal-close is-large" aria-label="close"/>

You are almost done! The only piece missing is the JavaScript sending emails to Google Sheets. You can take advantage of the following snippet at your site:

// This code requires jQuery

var $form = $("#newsletter-form");
var $email = $("#email");

var $modal = $("#subscription-success-modal");
var $signUp = $("#sign-up");

var $modalOK = $("#modal-ok-button");

$form.submit(function(e) {
  // Don't do anything if email field is empty
  var email = $email.val();
  if (!email) {

  // Mark the "signup" button as "loading"
  // make the request
    // Replace the URL with the one specific for your script
    url: "",
    data: JSON.stringify({
      method: "POST",
      sheet: "emails",
      payload: { email }
  }).then(function() {
    // Remove the "loading" state from the "signup" button 
    // Show the popup saying that user has been added
    // to the subscription list  

// Once user clicks "OK" on the popup saying that he 
// has been added to the subscription list we want to
// close the popup
$ {

That's it. From now your users can sign-up to the newsletter and you will add their emails on Google Sheets!

Last updated