Skip to main content

How to use Webhooks

Automatically Send Snappic Share Data to Google Sheets using Webhooks.

Marco avatar
Written by Marco
Updated over 2 weeks ago

Webhook provides a powerful way to send real-time data to external systems, eliminating the need for manual exports or constant updates.

By leveraging webhooks in Snappic, you can automatically send shared data to Google Sheets as soon as it's captured in your app. This ensures that your spreadsheets remain instantly updated with the latest event data, saving time and streamlining your workflow.

This guide will walk you through setting up webhooks to integrate Snappic with Google Sheets, making your data management seamless and efficient.


Table of Contents


Important Notes

  • This feature is available for Enterprise Plus accounts.

  • Pro events do not support webhooks, as they don't collect data at this time.

  • Currently, webhooks only support Share Data. If you need additional data capture functionalities, you can submit a feature request here.

  • For a visual, step-by-step video tutorial on webhooks with Google Sheets, click here.


Understanding Webhooks

A webhook is a way for one system to automatically send real-time data to another system. Instead of manually requesting data, your system will receive it as soon as an event occurs. Think of it like a notification system—when something happens on our platform, we send the relevant information to your webhook URL.

To use webhooks, you need a service or server on your end that can receive and process the data. This means setting up an endpoint (a specific URL) that can accept incoming HTTP POST requests and handle the JSON payload we send.

Our platform allows customers to configure a webhook endpoint, to which our system will push event-related data whenever a significant action occurs. Below is an overview of the data format sent to your webhook, along with explanations for each key component.


How to Set Up Webhooks with Google Sheets

Adding webhooks to Google Sheets

Open Google Sheets and create a new spreadsheet then click on Extensions > Add-ons > Get add-ons.

Search for Webhooks for Sheets and Install.

Configure Webhooks in Google Sheets

After installation, open Webhooks for Sheets.

When creating your webhook, ensure you enable the option to accept POST requests.

Click on "Create" to generate a URL that you can paste into Snappic.

Setting up Webhooks on The Snappic Dashboard

In your Snappic dashboard, Enable Webhook under the "Event Options."

Paste your copied Google Sheets webhook URL into the "Webhook URL" field.

Click Verify URL. Snappic will send a test request to confirm the endpoint's validity.

Use Send Test to confirm data appears correctly in your Google Sheet.

Once verified, click Save to activate the webhook.


Setting up Custom Webhooks (Advanced)

The first step is to ensure you have a server or service that can receive the webhook via a POST request and that it is live and accessible via the internet. Once you have that url, enter it into the "Webhook URL" field and click the "Verify URL" button. Our system will then send a test request to the specified endpoint to ensure that it is valid and can receive data. You will need the URL to be validated before you can save.

Once you have validated the URL, you can send test data to confirm that your service is receiving and processing the data correctly. Once the webhook is verified and saved, data for the event will be sent as sessions are uploaded. Please note that only data captured after the webhook is set up will be sent. Sessions and data captured before setting up the webhook will not be sent to the webhook.

Data Format:

The webhook payload is structured as a JSON object with the following fields:

{ 
"event_id": "<event_id>",
"session": {
"id": "<session_id>",
"direct_url": "<session_direct_url>",
"site_url": "<session_site_url>",
"type": "<session_type>"
},
"share_details": [
{ "id": "<share_detail_id>",
"type": "<share_type>",
"value": "<share_value>"
}
]
}

Data Breakdown:

event_id:

  • The ID of the Snappic event that the data is coming from

session:

  • Contains details about the photo booth session related to the event.

    • id: A unique identifier for the session.

    • direct_url: A direct link to download the session.

    • site_url: The session's microsite URL.

    • type: The type of session (e.g., still, gif, video, ai).

share_details

  • An array of sharing details, including if any media or content was shared during the session.

    • id: A unique identifier for the shared item.

    • type: The type of share (e.g., email, phone).

    • value: The actual shared content (e.g., recipient email or phone number).

Additional Security

Since your endpoint will be exposed to the Internet, we recommend securing it by validating the source. We provide a 'secret key' that will be sent in the POST data, which you can use to determine whether the source is coming from Snappic.


If you need any assistance or get stuck, don't hesitate to contact our excellent 24/7 support team.

Did this answer your question?