To create a new Webhook in the Shopify dashboard, follow the steps below:
Access Settings > Notifications.
Click the Webhooks section and click Create Webhook.
On the creation screen, select the event that will be responsible for triggering the data to SprintHub.
Provide the Passive Webhook URL, which will be responsible for handling this data. For example, creating a lead or executing additional actions on an existing lead in the instance.
In this example, we will use the Customer Creation.
Shopify Notifications.
Shopify Webhooks.
Add Webhook Modal.
Doing Automatic Event Mapping
To perform automatic mapping:
In SprintHub's Passive Webhook, click Automatic Mapping.
Then, go to Shopify and click Send Test within the Webhook configuration.
This will send a test trigger to SprintHub, allowing the platform to identify and map the fields automatically.
Sprinthub Webhook.
Send Test Button.
Webhook Settings
The "Identifier for" field defines which JSON key will be used as the lead's unique identifier — for example, the WhatsApp number — once the data arrives at SprintHub's Passive Webhook.
If a lead with that identifier already exists in the database, it will not be recreated; only the configured extra actions will be executed.
Identifier for.
Automatic Lead Creation.
Checking the Webhook Log
Inside the Webhook, it is possible to view the log record, including information such as created leads, identified leads, and other relevant details.
It is important to highlight that all data sent by Shopify will be present in the request body (key body).
There, it is possible to analyze each field sent in the event — such as customer ZIP code, full name, email, among others — making it easier to understand and map the data.
