Select a topic:
Payments

Webhooks Integration

The Webhooks integration allows you to send event data from Mangomint to other third-party applications, such as Klaviyo or Mailchimp.

The table below outlines all the available webhooks you can use to send event data and what they include.

Webhook

What's included

Appointment created

• Appointment details

• Online booking details

• Client details

• If it's the client's first appointment

• Who created the appointment and when

Appointment updated

• Appointment details (before and after)

• Online booking details

• Client details

• Who updated the appointment and when

Appointment deleted

• Appointment details

• Online booking details

• Client details

• Who deleted the appointment and when

• Cancellation type

Sale completed

• Timestamp when webhook was sent

• Sale details

• Line item details

• Client details

Sale reopened

• Timestamp when webhook was sent

• Sale details

• Line item details

• Client details

Sale voided

• Timestamp when webhook was sent

• Sale details

• Line item details

• Client details

Self checkout completed

• Timestamp when webhook was sent

• Sale details

• Line item details

• Client details

• Payment amount

• Payment time

• Cardholder name

• Last four of card number

Membership started

• Timestamp when webhook was sent

• Client details

• Membership name

• Membership price

• Product discount percentage

• Service discount percentage

Membership canceled

• Timestamp when webhook was sent

• Client details

• Membership name

• Membership price

• Product discount percentage

• Service discount percentage

Product inventory

• Sale number

• SKU

• New quantity

Note: Only sent for products with a SKU that track inventory.

Form submitted

• Timestamp when webhook was sent

• Appointment details

• Client details

• Form name

• Form field type

• Form field question/label

• Form field answer

• Uploaded file count

• Download links for uploaded files

• Who submitted the form and when

• IP address

Link copied
Appointment details
Link copied

For webhooks with appointment details, the following information is included:

  • Date

  • Time

  • Appointment notes

  • Service

  • Service price

  • Duration

  • Staff member

  • Total for all services

  • Service customizations

Link copied
Online booking details
Link copied

For webhooks with online booking details, the following information is included:

  • First name

  • Last name

  • Email

  • Phone

  • Address

  • IP address

Link copied
Client details
Link copied

For webhooks with client details, the following information is included:

  • First name

  • Last name

  • Email

  • Phone

  • Social media details

  • Gender

  • Birthday

  • Referral source

  • Tags

  • Address

  • Appointment messaging preferences

  • Client notes

  • Who created the client and when

Link copied
Sale details
Link copied

For webhooks with sale details, the following information is included:

  • Sale number

  • Sale date

  • Tax

  • Tip

  • Sale total

  • Sale notes

  • Receipt links (online and print versions)

  • Who created the sale and when

  • Who updated the sale and when

  • Who closed the sale and when

  • Who reopened the sale and when

  • Who voided the sale and when (only open sales can be voided)

  • Who deleted (i.e. discarded) the sale and when (only open sales with no completed payments can be discarded)

Link copied
Line item details
Link copied

For webhooks with line item details, the following information is included:

  • Line item type (service, product, gift card, membership, package, entire-sale offer, account balance deposit, or custom fee)

  • Tax percentage

  • Tax amount

  • Discount percentage (from a membership or manual discount)

The following details are included for each line item type:

  • Link copied
    Service
    • Service category

    • Service name

    • Final price (before discounts)

    • Custom price (after discounts)

    • Staff member

      • Staff member name

      • Staff member email

      • Staff member phone

    • If it's the client's first appointment

    • Offer name

    • Offer discount percentage

    • Offer discount amount

  • Link copied
    Product
    • Product category

    • Product name

    • Product SKU

    • Product quantity

    • Unit price

    • Custom unit price

    • Final price (after discounts)

    • Staff member

    • Offer name

    • Offer discount percentage

    • Offer discount amount

  • Link copied
    Gift Card
    • Gift card number

    • Gift card amount

    • Gift card custom price

    • Gift card final price

    • Staff member

    • Gift card recipient

      • Client first name

      • Client last name

      • Email

      • Gift message

  • Link copied
    Membership
    • Membership name

    • Membership billing period start and end date

    • Membership price

    • Membership custom price (empty)

    • Membership final price (same as membership price)

  • Link copied
    Package
    • Package name

    • Package price

    • Package custom price

    • Staff member

  • Link copied
    Entire-Sale Offer
    • Offer name

    • Offer discount percentage

    • Offer discount amount

    • Who applied the offer

  • Link copied
    Account Balance Deposit
    • Account balance deposit amount

    • Account balance deposit note (empty)

    • Who closed the sale and when

  • Link copied
    Custom Fee
    • Custom fee name

    • Custom fee calculation type (fixed amount or percentage)

    • Custom fee rate (percentage)

    • Custom fee base amount (what the fee was applied to)

    • Custom fee amount

    • If the custom fee was waived

  • Link copied
    Webhooks functionality
    Link copied

    Webhooks have the following functionality:

    • Money: Prices, taxes, tips, discounts, totals, and payment amounts are sent as text strings instead of numbers.

    • Empty values: Sent as null instead of being omitted.

    • Timestamps: Sent in ISO 8601 UTC format. UTC does not apply to appointment dates and times, which are sent in local time.

    Link copied
    Getting started with webhooks
    Link copied

    To get started with webhooks, contact chat support. We can help you set up your webhooks based on the endpoint URLs you provide. Endpoint URLs are often created using tools such as Zapier or Pipedream.

    Start a chat with us

    Can't find what you're looking for?

    with us to talk to a real person and get your questions answered, or browse our on-demand videos.