What if I told you it can be done with zero dependencies? Hope you’re up for a challenge because that’s exactly what we’ll be doing. This tutorial will cover the basics of both the front-end contact form, with vanilla JavaScript, and the serverless back end hosted on . is the service you use for sending the actual emails and trust me, it’s so incredibly simple the configuration takes 13 seconds. Yes, I timed myself. 😁 AWS Lambda AWS SES Well, okay then. Let’s jump in! TL;DR Just to make sure you have an overview of what we’re doing today, here’s a short TL;DR. You can jump to the section that interests you, and severely hurt my feelings, or just keep reading from here. Take your pick… I won’t silently judge you. 😐 What are we building? Configure AWS SES Build the API with the Serverless Framework Deploy the API to AWS Lambda Test the API with Dashbird Build the form Note : I turned this code into an npm module for easier re-usability, and so you peeps don’t need to write all the code yourself when you need a quick contact form. What are we building? The general idea is to build a contact form that can be added to a static website. We want to add it without managing any servers and ideally not paying anything for it to run. Here’s an amazing use case for AWS Lambda. The structure of what we want to build is rather simple. We have a simple form, with a tiny snippet of JavaScript to parse the parameters to JSON and send them to an API endpoint. The endpoint is an event, which will trigger an AWS Lambda function. The function will tell AWS SES to send an email with the content to your email address. From there you can continue exchanging emails with the person who filled out the form. Simple, right? AWS API Gateway API Diagram Let’s start hacking! Configure AWS SES In order to send emails with the Simple Email Service AWS provides, you need to verify an email address which will be used to send the emails. It’s as simple as navigating to the AWS Console and searching for . Simple Email Service Once there press the link on the left side navigation. You’ll see a big blue button called . Press it and add your email address. Email Addresses Verify a New Email Address AWS will now send you a verification email to that address. Go ahead and verify it. That’s pretty much it. Ready to write some code now? Build the API with the Serverless Framework There are a couple of main steps in building the actual API. First thing, as always, is the configuration. 1. Install the Serverless Framework In order for serverless development to be absolute torture, go ahead and install the . not Serverless framework $ npm i -g serverless Note: If you’re using Linux, you may need to run the command as sudo. Once installed globally on your machine, the commands will be available to you from wherever in the terminal. But for it to communicate with your AWS account you need to configure an IAM User. Jump over , then come back and run the command below, with the provided keys. here for the explanation $ serverless config credentials \     --provider aws \     --key xxxxxxxxxxxxxx \     --secret xxxxxxxxxxxxxx Now your Serverless installation knows what account to connect to when you run any terminal command. Let’s jump in and see it in action. 2. Create a service Create a new directory to house your Serverless application services. Fire up a terminal in there. Now you’re ready to create a new service. What’s a service you ask? View it like a project. But not really. It’s where you define AWS Lambda functions, the events that trigger them and any AWS infrastructure resources they require, all in a file called . serverless.yml Back in your terminal type: $ serverless create --template aws-nodejs --path contact-form-api The create command will create a new . Shocker! But here’s the fun part. We need to pick a runtime for the function. This is called the . Passing in will set the runtime to Node.js. Just what we want. The will create a folder for the service. service template aws-nodejs path 3. Explore the service directory with a code editor Open up the folder with your favorite code editor. There should be three files in there, but for now, we’ll only focus on the . It contains all the configuration settings for this service. Here you specify both general configuration settings and per function settings. Your will be full of boilerplate code and comments. Feel free to delete it all and paste this in. contact-form-api serverless.yml serverless.yml The property lists all the functions in the service. We will only need one function though, to handle the sending of emails. The references which function it is. functions handler Take a look at the , they specify the Lambda has permission to trigger the . iamRoleStatements Simple Email Service We also have a section at the top. This acts as a way to safely load environment variables into our service. They're later referenced by using where the actual values are kept in a simple file called . custom ${self:custom.secrets.<environment_var>} secrets.json Awesome! 4. Add the secrets file We all know pushing private keys to GitHub kills little puppies. Please don’t do that. Handling this with the Serverless Framework is simple. Add a file and paste these values in. secrets.json While testing you can keep the domain as , however, make sure to change this to your actual domain in production. The field should contain the email you verified with AWS SES. '*' EMAIL 5. Write business logic With that wrapped up, let’s write the actual code. All in all, the code itself is rather simple. We’re requiring the module, creating the email parameters and sending them with the method. At the bottom, we're exporting the function, making sure to make it available in the . SES .sendMail() serverless.yml That’s it, all about 60 lines of code, with absolutely no dependencies. Sweet! Deploy the API to AWS Lambda Here comes the easy part. Deploying the API is as simple as running one command. $ serverless deploy You can see the endpoint get logged to the console. That’s where you will be sending your requests. Test the API with Dashbird The simplest way of testing an API is with CURL. Let’s create a simple CURL command and send a JSON payload to our endpoint. $ curl --header "Content-Type: application/json" \   --request POST \   --data '{"email":"john.doe@email.com","name":"John Doe","content":"Hey!"}' \ https://{id}.execute-api.{region}.amazonaws.com/{stage}/email/send If everything works like it should, you will get an email shortly. If not, well then you’re out of luck. In cases like these, I default to using to debug what’s going on. It’s to set up. Dashbird free and doesn’t require a credit card The logs on my end are showing all green, so it’s working perfectly! That’s the API part done. Let’s move on to the contact form itself. Build the contact form Because I’m not the best CSS guru in the world, I’ll just entirely skip that part and show you how to make it work. 😁 Let’s start with the HTML markup. It’s an incredibly simple form with three fields and a button. Let’s move on to the JavaScript. Another 50 lines and you have the client side logic done. Feel free to drop this into your website, change the constant to the API endpoint you deployed above. Hey presto, there's your serverless contact form done and ready for production! url Wrapping up There you have it, a quick and easy way to add a serverless contact form to a website. Using serverless for the odd, isolated endpoint like this is great. There are absolutely no servers you need to worry about. Just deploy the code and rest assured it’ll work. If something breaks, you have watching your back, alerting you in Slack if something is wrong. Damn, I love Slack integrations. Dashbird Anyhow, I took the time to create an out of the code above, so in the future, nobody needs to write this twice. Just install the package and there’s your contact form endpoint up and running in less than a minute. You can find the instructions in the , if you want to take a look. Give it a star if you want more people to see it on GitHub. npm module GitHub repo If you want to read some of my previous serverless musings head over to or my profile join my newsletter! Or, take a look at a few of my articles right away: A crash course on Serverless APIs with Express and MongoDB Solving invisible scaling issues with Serverless and MongoDB How to deploy a Node.js application to AWS Lambda using Serverless Getting started with AWS Lambda and Node.js A crash course on securing Serverless APIs with JSON web tokens Migrating your Node.js REST API to Serverless Building a Serverless REST API with Node.js and MongoDB A crash course on Serverless with Node.js Hope you guys and girls enjoyed reading this as much as I enjoyed writing it. If you liked it, slap that tiny clap so more people here on Medium will see this tutorial. Until next time, be curious and have fun. Originally published at dev.to .

Amazon

Slack

This Month's Sponsor is Tracetest!

Read My Stories

Too Long; Didn't Read

Let Your Engineers & PMs focus on Product. Apply for $50K Credits!

Building a serverless contact form with AWS Lambda and AWS SES

Too Long; Didn't Read

People Mentioned

Companies Mentioned

@adnanrahic

RELATED STORIES