Gearment Webhook API (1.0.0)

The Gearment Webhook API provides real-time notifications for critical order and product events—such as order completion, cancellation, shipping updates, stock changes, and variant modifications—across multiple payload versions to ensure seamless integration with your existing systems.

Download OpenAPI description
Overview
Support Integration

integration@gearment.com

Languages
Servers
Your Webhook URL

https://your-webhook-url/

Overview

Webhook events are one-way events sent to your app over HTTP to notify you when an event occured. Unlike events that are sent over Gateway connections, events sent over webhooks are not realtime or guaranteed to be in order.

While incoming webhooks are triggered by an external service, webhook events (i.e. outgoing webhooks) are triggered by events happening in Gearment. This means your app will need to set up a public URL where you can receive HTTP events, which is detailed in the preparing for events section.

You can configure only one webhook URL per webhook event and version.

Setting Up Webhooks

To configure webhook events, you'll need to configure your URL and select the events you want your app to receive.

In your team's settings, navigate to the Webhooks page from the left-hand sidebar.

  1. Under Developer Settings, click Webhooks, add a Add Webhook that is set up to receive and acknowledge webhook events.
    • Details about payload found in the Preparing for Events section.
  2. Setup Webhook name and Delivery URL
  3. Select the webhook events and version you want your app to receive.
  4. Click Save.

If your URL is successfully verified, your app should begin receiving the events you selected.

Simulate webhook

To test your webhook URL, you can use the Simulate Webhook feature. This allows you to send a test payload to your webhook URL to ensure that it is set up correctly and can handle incoming requests.

  1. In the Webhooks page, click on the Webhook simulator button.
  2. Setup Delivery URL
  3. Select the event type you want to simulate.
  4. Click Send.

Signature

When Gearment sends an alert payload to your webhook URL, we include a variety of headers that you can use to verify that the payload came from QuickAlerts. For additional security, you can implement signature validation, which is an optional way to verify the authenticity of payloads received by your webhook URL.


Payload

Webhook events that can be received from Gearment

Webhooks