# serverless-function-examples

**Repository Path**: mirrors_HubSpot/serverless-function-examples

## Basic Information

- **Project Name**: serverless-function-examples
- **Description**: A collection of HubSpot related serverless functions examples.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-13
- **Last Updated**: 2026-01-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## HubSpot Serverless Function Examples
This repository contains a collection of serverless functions written by both HubSpot and the community. It serves as a reference to be used when creating new functions, or seeking existing functions to fulfill a specific task.

### What is a serverless function?
Serverless functions provide a way to write server-side code that interacts with HubSpot and third-party services through APIs. APIs requiring authentication are not safe for the front-end of a website, as your credentials would be exposed. Serverless functions can act as an intermediary, enabling you to keep credentials secret. For more info, please see the [HubSpot Serverless Function Docs](https://developers.hubspot.com/docs/cms/features/serverless-functions) or the [HubSpot Serverless Functions: Getting Started guide](https://developers.hubspot.com/docs/cms/guides/getting-started-with-serverless-functions).

### In which ways can serverless functions be used within HubSpot?
Serverless functions were introduced in April 2020 and functionality has been expanded since then to allow custom packages, local testing, and greater visibility into logs to simplify development. Currently, we have serverless function examples that can interact with the following areas of HubSpot:

- [CMS](cms)

### Testing Functions
Tests are run by the [test-examples github action](https://github.com/HubSpot/serverless-function-examples/actions?query=workflow%3Atest-examples) on `push`.

Tests can also be run locally using `npm run test`.

To add tests:
- Add a test file with the extension `.test.js` in your `.functions` folder that includes your expectations using jest/jasmine ([Example hello-world Test](cms/hello-world/hello-world.functions/hello-world.test.js))
- The serverless function will be run within the github action using the [tests/globalTestSetup.js config](tests/globalTestSetup.js) which utilizes the [serverless-dev-runtime package](https://www.npmjs.com/package/@hubspot/serverless-dev-runtime) to run the example functions