Shows all the V2 webhooks for Square API endpoints.
Webhooks

V2 Webhook Events Reference

Webhooks let you subscribe to Square API events and receive notice when an event occurs. For more information about how to set up a webhook subscription, see Webhooks Overview.

Bank Accounts API Permalink Get a link to this section

EventDescription
bank_account.disabledPublished when Square sets the status of a bank account to DISABLED.
bank_account.verifiedPublished when Square sets the status of a bank account to VERIFIED.
bank_account.createdPublished when you link an external bank account to a Square account in the Seller Dashboard. Square sets the initial status to VERIFICATION_IN_PROGRESS and publishes the event.
For information about using the Bank Accounts API, see Bank Accounts API.

Bookings API Permalink Get a link to this section

EventDescription
booking.createdA booking is created by calling CreateBooking.
booking.updatedAn API-created booking is updated in the Seller Dashboard, on the seller's online booking site, or by calling UpdateBooking.
For more information about booking events, see Handle Booking Event Notifications with Webhooks. For information about using the Bookings API, see Manage Bookings for Square Sellers.

Cards API Permalink Get a link to this section

EventDescription
card.automatically_updatedPublished when card expiration information or pan is automatically updated.
card.createdPublished when a card is created or imported.
card.disabledPublished when a card is disabled.
card.forgottenPublished when a card is GDPR forgotten/vaulted.
card.updatedPublished when a card is updated by the developer using the UpdateCard endpoint.
For information about using the Cards API, see Cards API Overview.

Catalog API Permalink Get a link to this section

EventDescription
catalog.version.updatedThe catalog was updated. Webhook notification data is packaged as "catalog_version": { "updated_at": "2019-05-14T17:51:27Z"}.
For more information about catalog events, see Webhooks. For information about using the Catalog API, see What It Does.

Customers API Permalink Get a link to this section

EventDescription
customer.createdA customer profile is created, including when customer profiles are merged into a new customer profile.
customer.deletedA customer profile is deleted, including when customer profiles are merged into a new customer profile.
customer.updatedAn attribute on a customer profile is changed, except for the following:
   cards (deprecated)
   segment_ids
For more information about customer events, see Use Customer Webhooks. For information about using the Customers API, see Manage Customers and Integrate with Other Services.

Customer Custom Attributes API Permalink Get a link to this section

Subscribe to the following events to receive notifications for changes to custom attribute definitions and custom attributes that are owned by the subscribing application:

Event
Description
customer.custom_attribute_definition.createdA custom attribute definition was created by your application.
customer.custom_attribute_definition.updatedA custom attribute definition owned by your application was updated. Note that only the definition owner can update a custom attribute definition.
customer.custom_attribute_definition.deletedA custom attribute definition owned by your application was deleted. Note that only the definition owner can delete a custom attribute definition.
customer.custom_attribute.updatedA custom attribute owned by your application was created or updated for a customer profile. A custom attribute is owned by the application that created the corresponding definition.
customer.custom_attribute.deletedA custom attribute owned by your application was deleted from a customer profile. A custom attribute is owned by the application that created the corresponding definition.

Subscribe to the following events to receive notifications for changes to custom attribute definitions and custom attributes that are publicly visible:

Event
Description
customer.custom_attribute_definition.public.createdA publicly visible custom attribute definition was created.
customer.custom_attribute_definition.public.updatedA publicly visible custom attribute definition was updated.
customer.custom_attribute_definition.public.deletedA publicly visible custom attribute definition was deleted.
customer.custom_attribute.public.updatedA publicly visible custom attribute was created or updated for a customer profile.
customer.custom_attribute.public.deletedA publicly visible custom attribute was deleted from a customer profile.
For more information about customer-related custom attribute events, see Webhooks. For information about using the Customer Custom Attributes API, see Custom Attributes for Customer Profiles.

Devices API Permalink Get a link to this section

EventDescription
device.code.pairedA Square Terminal has been paired with a Terminal API client and the device_id of the paired Square Terminal is available.
For information about using the Devices API, see Connect a Square Terminal.

Disputes API Permalink Get a link to this section

EventDescription
dispute.createdA dispute was created.
DEPRECATED: dispute.state.changedThe state of a dispute changed. This includes the dispute resolution (WON or LOST) reported by the bank. The event data includes details about what changed.
dispute.state.updatedThe state of a dispute changed. This includes the dispute resolution (WON or LOST) reported by the bank. The event data includes details about what changed.
DEPRECATED: dispute.evidence.addedEvidence was added to a dispute from the Disputes Dashboard in the Seller Dashboard, in the Square Point of Sale application, or by calling the Disputes API (CreateDisputeEvidenceFile or CreateDisputeEvidenceText).
dispute.evidence.createdEvidence was added to a dispute from the Disputes Dashboard in the Seller Dashboard, in the Square Point of Sale application, or by calling the Disputes API (CreateDisputeEvidenceFile or CreateDisputeEvidenceText).
dispute.evidence.deletedEvidence was removed from a dispute from the Disputes Dashboard in the Seller Dashboard, in the Square Point of Sale application, or by calling DeleteDisputeEvidence.
DEPRECATED: dispute.evidence.removedEvidence was removed from a dispute from the Disputes Dashboard in the Seller Dashboard, in the Square Point of Sale application, or by calling DeleteDisputeEvidence.
For more information about dispute events, see Disputes webhook notifications. For information about using the Disputes API, see Disputes Overview.

Gift Cards API Permalink Get a link to this section

EventDescription
gift_card.createdA gift card was created.
gift_card.updatedA gift card was updated. The attributes on a gift card that can be updated are balance_money, state, and customer_ids.
gift_card.customer_linkedA customer was linked to a gift card.
gift_card.customer_unlinkedA customer was unlinked from a gift card.
gift_card.activity.createdA gift card activity was created.
For more information about gift card events, see Gift Cards API Webhooks. For information about using the Gift Cards API, see Gift Cards API Overview.

Inventory API Permalink Get a link to this section

EventDescription
inventory.count.updatedThe quantity was updated for a catalog item variation. Webhook notification data is packaged as InventoryCount[].
For information about using the Inventory API, see What It Does.

Invoices API Permalink Get a link to this section

EventDescription
invoice.createdA draft invoice was created.
invoice.publishedAn invoice was published. This also applies to invoices that are published but scheduled to be processed at a later time.
invoice.updatedAn invoice was changed. This event is also invoked following invoice.published and invoice.canceled events.
invoice.payment_madeA payment was made for an invoice.
invoice.scheduled_charge_failedA scheduled automatic payment has failed.
invoice.canceledAn invoice was canceled.
invoice.refundedA refund was processed for an invoice.
invoice.deletedA draft invoice was deleted. A deleted invoice is removed entirely from the seller account and cannot be retrieved.
For information about using the Invoices API, see Manage Invoices Using the Invoices API.

Labor API Permalink Get a link to this section

EventDescription
labor.shift.createdA worker started a shift.
Webhook notification data is packaged as a Shift.
labor.shift.updatedA shift was updated.
Typically a break was started or ended or a worker ended the shift.
Webhook notification data is packaged as a Shift.
labor.shift.deletedA shift was deleted.
Notification data includes the deleted shift ID and the isDeleted flag.
For information about using the Labor API, see Labor API.

Locations API Permalink Get a link to this section

EventDescription
location.createdA Location was created.
location.updatedA Location was updated.
For information about using the Locations API, see Locations API.

Loyalty API Permalink Get a link to this section

Event Description
loyalty.account.created Published when a loyalty account is created for a buyer. A loyalty account can be created using any of the following methods, which all publish this event:
  • An application calls the CreateLoyaltyAccount endpoint.
  • A buyer enrolls in the program from a Square Point of Sale application.
  • The seller enrolls a buyer using the Customer Directory.
  • The seller merges two customer accounts into one account using the Customer Directory. In this process, sellers might merge the two corresponding loyalty accounts by creating a new account and deleting the existing accounts.
loyalty.account.updated Published for any updates to an existing loyalty account. For example:
  • The seller updates the phone number registered for the loyalty account using the Seller Dashboard. For more information, see Square Loyalty FAQ.
  • Any change in the loyalty point balance, such as points added for visits, points expiration, or a manual adjustment to the point balance that a seller might perform.
  • The customer ID of the loyalty account changes. Perhaps the loyalty account moves to another customer.
loyalty.account.deleted Published when a loyalty account is deleted. The published event does not contain the customer_id that was associated with the deleted account. The following actions to delete the account can publish this event:
  • The seller deletes an account using the Seller Dashboard.
  • The seller merges two customer accounts into one account using the Customer Directory. In this process, sellers might merge the two corresponding loyalty accounts by creating a new account and deleting the existing accounts.
loyalty.program.created Published when a loyalty program is created using the Seller Dashboard.
loyalty.program.updated Published when a loyalty program is updated using the Seller Dashboard.
loyalty.event.created Square Loyalty maintains a ledger of events that occur over the lifetime of a loyalty account. Square publishes notifications for each loyalty event logged to the ledger. These loyalty events are immutable, which means they are never updated or deleted. For example, when a buyer redeems a reward and then returns it, Square publishes separate notifications for the corresponding CREATE_REWARD and DELETE_REWARD events. Similarly, Square publishes a notification for the ADJUST_POINTS event when points are deducted after a purchase that accrued points is refunded.
For information about using the Loyalty API, see Manage Loyalty Accounts Using the Loyalty API.

OAuth API Permalink Get a link to this section

EventDescription
oauth.authorization.revokedNotifies an application whenever a seller revokes all access tokens and refresh tokens granted to the application.
For information about using the OAuth API, see OAuth Overview.

Orders API Permalink Get a link to this section

EventDescription
order.createdAn Order was created. This event is triggered only by the CreateOrder endpoint call.
order.fulfillment.updatedAn OrderFulfillment was created or updated. This event is triggered only by the UpdateOrder endpoint call.
order.updatedAn Order was updated. This event is triggered only by the UpdateOrder endpoint call.
For information about using the Orders API, see What It Does.

Payments API Permalink Get a link to this section

EventDescription
payment.createdA Payment was created.
payment.updatedA Payment was updated. Typically the payment.status or card_details.status field is updated when a payment is canceled, authorized, or completed.
For information about using the Payments API, see Payments API and Refunds API Overview.

Refunds API Permalink Get a link to this section

EventDescription
refund.createdA Refund was created.
refund.updatedA Refund was updated. Typically the refund.status field changes when a refund is completed.
For information about using the Refunds API, see Payments API and Refunds API Overview.

Subscriptions API Permalink Get a link to this section

EventDescription
subscription.createdPublished whenever the Subscription object is created.
subscription.updatedPublished whenever the Subscription object changes.
For information about using the Subscriptions API, see Manage Subscriptions Using the Subscriptions API.

Team API Permalink Get a link to this section

EventDescription
team_member.createdA new team member was created.
team_member.updatedA team member was updated.
team_member.wage_setting.updatedA new team member wage setting was updated.
For information about using the Team API, see Team API.

Terminal API Permalink Get a link to this section

EventDescription
terminal.action.createdA TerminalAction request was created.
terminal.action.updatedA TerminalAction request was updated.
terminal.checkout.createdA TerminalCheckout request was created.
terminal.checkout.updatedA TerminalCheckout status was changed.
terminal.refund.createdA TerminalRefund request was created.
terminal.refund.updatedA TerminalRefund status was changed.
For information about using the Terminal API, see Square Terminal Integration Overview.

Vendors API Permalink Get a link to this section

EventDescription
vendor.createdPublished when a vendor is created by calling CreateVendor or BulkCreateVendors, as well as using the Square Seller Dashboard.
vendor.updatedPublished when a vendor is updated by calling UpdateVendor or BulkUpdateVendors, as well as using the Seller Dashboard.
For more information about vendor events, see Receive Vendors Webhook Events. For information about using the Vendors API, see Manage Suppliers of a Seller.

If you need more assistance, contact Developer Support or ask for help in the Developer Forums.