Skip to main content

Cents API Guide

Euri Romanov avatar
Written by Euri Romanov
Updated this week

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:

  1. 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.

  2. 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.

  3. Cents enables event triggers for your account
    Your CSM will add your endpoint(s) to your account to enable Cents webhook events.

  4. 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.

  5. 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.


Did this answer your question?