Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

  • Commerce

  • Customers

    • Customers

    • Customer Custom Attributes

    • Customer Groups

    • Customer Segments

    • Loyalty

    • Gift Cards

    • Gift Card Activities

  • Staff

  • Merchants

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Loyalty

Enroll buyers in a Square loyalty program, view program settings, manage and track loyalty activity, and create and manage promotions.

Sellers subscribe to Square Loyalty to offer a loyalty program that can increase repeat visits to their business by rewarding customers.

Use the Loyalty API to create loyalty accounts for buyers and enable them to earn points for purchases and redeem points for reward discounts. Also use the Loyalty API to retrieve details about the loyalty program, create and manage loyalty promotions that extend the base program, and track balance-changing events for loyalty accounts.

For more information, see the following guides:

  • Loyalty
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

Create loyalty account

POST/v2/loyalty/accounts

Creates a loyalty account.

Search loyalty accounts

POST/v2/loyalty/accounts/search

Searches for loyalty accounts in a loyalty program.

Retrieve loyalty account

GET/v2/loyalty/accounts/{account_id}

Retrieves a loyalty account.

Accumulate loyalty points

POST/v2/loyalty/accounts/{account_id}/accumulate

Adds points earned from a purchase to a loyalty account.

Adjust loyalty points

POST/v2/loyalty/accounts/{account_id}/adjust

Adds points to or subtracts points from a buyer's account.

Search loyalty events

POST/v2/loyalty/events/search

Searches for loyalty events.

Retrieve loyalty program

GET/v2/loyalty/programs/{program_id}

Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword main.

Calculate loyalty points

POST/v2/loyalty/programs/{program_id}/calculate

Calculates the number of points a buyer can earn from a purchase.

List loyalty promotions

GET/v2/loyalty/programs/{program_id}/promotions

Lists the loyalty promotions associated with a loyalty program.

Create loyalty promotion

POST/v2/loyalty/programs/{program_id}/promotions

Creates a loyalty promotion for a loyalty program.

Retrieve loyalty promotion

GET/v2/loyalty/programs/{program_id}/promotions/{promotion_id}

Retrieves a loyalty promotion.

Cancel loyalty promotion

POST/v2/loyalty/programs/{program_id}/promotions/{promotion_id}/cancel

Cancels a loyalty promotion.

Create loyalty reward

POST/v2/loyalty/rewards

Creates a loyalty reward.

Search loyalty rewards

POST/v2/loyalty/rewards/search

Searches for loyalty rewards.

Delete loyalty reward

DELETE/v2/loyalty/rewards/{reward_id}

Deletes a loyalty reward by doing the following: - Returns the loyalty points back to the loyalty account.

Retrieve loyalty reward

GET/v2/loyalty/rewards/{reward_id}

Retrieves a loyalty reward.

Redeem loyalty reward

POST/v2/loyalty/rewards/{reward_id}/redeem

Redeems a loyalty reward.