Cents provides webhook support so your systems can stay in sync with real-time customer and order activity. By subscribing to specific events, you can automate workflows and trigger actions in external systems when changes occur in Cents.
This guide covers:
Supported webhook events
Common integration use cases
Example payloads for customer and order events
Supported Webhook Events
Cents currently supports the following webhook events:
Customer Created (customer_created)
Customer Updated (customer_updated)
Order Created (order_created)
Order Updated (order_updated)
Whenever one of these events is triggered, Cents will send a POST request with a JSON payload to the webhook URL(s) you provide.
Common Use Cases
Here are a few examples of how these events can be used:
Customer Created / Updated
Sync data with the Business Manager
Segment users based on commercial vs residential accounts
Order Created / Updated
Alert staff via internal messaging tools
Log order activity in a spreadsheet or dashboard
Create tasks in project management software
Example Payloads
Below are sample JSON payloads for each type of event.
Customer Events
{
"action": "customer_created", // or "customer_updated"
"customer": {
"id": "cust_12345",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+1 555-1234",
"businessName": "John's Cleaners",
"email": "[email protected]",
"isCommercial": false,
"isInvoicingEnabled": false
},
"customerMetrics": {
"numOrders": 5,
"totalOrderValue": 250.0,
"lastOrderDate": "2025-02-14T10:00:00Z",
"creditBalance": 10.0,
"loyaltyPointsBalance": 200
}
}
Order Events
{
"action": "order_created", // or "order_updated"
"order": {
"id": "ord_98765",
"storeName": "LaundryExpress #1",
"status": "Pending",
"orderTotal": 29.99,
"placedAt": "2025-02-14T10:05:00Z",
"completedAt": null,
"orderCode": "LX-00123",
"tipAmount": 3.0,
"creditAmount": 0.0,
"promotionAmount": 2.0,
"balanceDue": 24.99,
"returnMethod": "Pickup",
"pickupDeliveryFee": 5.0,
"pickupDeliveryTip": 1.0,
"returnDeliveryFee": 5.0,
"returnDeliveryTip": 1.0,
"recurringDiscountInCents": 0,
"dueDate": "2025-02-15T10:05:00Z",
"services": [
{
"id": "svc_11111",
"name": "Wash & Fold",
"quantity": 1,
"totalPrice": 25.0,
"unitCost": 25.0,
"modifiers": [
{
"id": "mod_56789",
"name": "Stain Treatment",
"pricingType": "flat",
"totalPrice": 4.99,
"unitCost": 4.99,
"quantity": 1
}
]
}
]
},
"customer": {
"id": "cust_54321",
"firstName": "Jane",
"lastName": "Smith",
"phoneNumber": "+1 555-6789",
"businessName": "Jane's Bakery",
"email": "[email protected]",
"isCommercial": false,
"isInvoicingEnabled": false
},
"customerMetrics": {
"numOrders": 12,
"totalOrderValue": 450.75,
"lastOrderDate": "2025-02-13T15:30:00Z",
"creditBalance": 5.0,
"loyaltyPointsBalance": 320
}
}
Getting Started
To begin using webhooks with Cents:
Set up your publicly accessible HTTP POST endpoint to receive webhook payloads. Make sure to test your endpoint, otherwise you will receive a webhook disabled email.
Share your webhook endpoint(s) with your CSM
Once your endpoints are tested and ready, send the URL(s) to your Cents Customer Success Manager. You can share one or multiple endpoints depending on your setup.
Cents enables event triggers for your account
Your CSM will add your endpoint(s) to your account to enable Cents webhook events.
Start receiving real-time data
Once configured, Cents will begin sending event payloads to your endpoint(s) as they occur. Each event includes structured JSON data for easy parsing.
Choose your integration path
Build your own workflow: Write custom code to handle webhook events and trigger downstream systems (e.g., update a CRM or internal dashboard).
Use a no-code tool like Zapier: Let Zapier catch webhooks and automate tasks across apps (e.g., send customer messages, log data to Google Sheets, update marketing tools). Check out our Zapier Integration Guide here.
Need Help?
Webhooks let you automate your workflow and keep your systems aligned with real-time data from Cents. Check out our Zapier Integration Guide if you have want to explore a no-code way to utilize webhooks.