Community Articles Sending Emails with the SendGrid Function

Sending Emails with the SendGrid Function

We recently released Cosmic Functions (public beta). We're excited to help teams build amazing modern products together with new serverless solutions.

In this short tutorial, I'm going to show you how to get up and running with the SendGrid Email Function to send emails via SendGrid (to view more example functions login and go to Your Bucket > Settings > Functions).

Deploying the Function

1. Install the function
To install the SendGrid function, go to Your Bucket > Settings > Functions, find the SendGrid function, and click "Install Function".

2. Add keys, and deploy
After you install the function, you will be redirected to a page to add your AWS credentials and environment variables. Follow the steps to add your AWS creds (if you don't have them handy).

Go to your SendGrid account and find your API Secret Key located in Settings > API Keys (you may need to create a new one) and add this as the value to SENDGRID_API_KEY.

Once you have your keys added, click "Deploy Function" and in a minute your function will be deployed and ready for requests.

Code a Web Contact Form

Next, let's create a contact form to access the newly deployed endpoint. Follow these steps to install the React Starter:

npm i -g cosmic-cli
cosmic init react-starter
cosmic develop

Now go to your app codebase and go to the default page component located in pages/default.js and edit it to look like this:

Notice a couple things here:

1. We've added a form element to take the input for email, first name, and last name.
2. We've added the handleSubmit method to handle the form submission which takes the values of the form and sends the data to our Cosmic Function endpoint.

And that's it! We've now got an endpoint that receives the data from our form and sends it to the SendGrid API for processing.

Benefits

Less Code
We didn't have to worry about building an API endpoint in our app to send the data to SendGrid.

Less Config Hassles
We don't have to worry about config hassles like possibly leaking secret keys client-side. We don't have to share API keys with anyone else, just the endpoint. Config is handled in the Cosmic Function as an Environment Variable.

Reusable
We can use this endpoint in any other app that needs to send an email.

I hope you enjoyed this quick tour of the SendGrid Function, now ready for installation and deployment (go to Your Bucket > Settings > Functions). Let me know if you have any questions or comments. Reach out to us on Twitter and join our Slack community.

Was this article helpful?

Thank you! Your input helps us improve our articles and resources. If you have any other questions or comments, please contact support.

You may also like


Now editors can use the new Unsplash Photos Extension to find and add stock photography to their media library, all from the comfort of their Bucket Dashboard without having to interface with a third-party website like Unsplash.
This article shows you how to create a blazing fast Gatsby JS blog using Cosmic JS source plugin. Let’s get started.
Metadata is extremely important for SEO as it speaks to search engines directly from each page crawled, to communicate important information or request a specific action from the search engine. Cosmic JS provides an easy modal to manage media metadata.
In this blog we'll quickstart a React ToDo App using the Cosmic JS CLI. This is a simple todo application that consumes the Cosmic JS API and is built using React, Redux, Node.js and Webpack.
With revision history, you no longer have to worry about editing mistakes. You now have the power to go back in time and revert to to prior versions.
Cosmic Community Member Reagan McFarland just debuted the new Alexa Skill codebase to add Objects to your Cosmic JS Bucket via voice. In this video, Cosmic JS co-founder Tony Spiro takes you on a quick tour of how to demo the Alexa To Do app from the Alexa developer console.

Ready to Get Started?

No payment info required.
Start Now   Contact Sales