Skip to main content
Crave integrates with Square POS to import your existing catalog (menus, categories, products, modifiers) and keep orders in sync. This guide covers the full setup flow.

​
How it works

1

Connect Square via OAuth

Authorize Crave to access your Square account.
2

Select a Square location

Map a Square location to your Crave location.
3

Import your catalog

Pull menus, categories, products, and modifiers from Square into Crave.
4

Accept orders

Orders placed on your storefront appear in both Crave and Square.

​
Prerequisites

  • A Crave account with at least one location
  • A Square account with a catalog set up
  • Dashboard access (admin or owner role)

​
Connect Square

  1. In the Crave Dashboard, go to Settings > Integrations > Square
  2. Click Connect Square
  3. You’ll be redirected to Square’s OAuth authorization page
  4. Grant Crave access to your Square account
  5. After authorization, you’re redirected back to the Dashboard
The connection status appears on the integration page:
StatusMeaning
connectedOAuth successful, ready to select a location
disconnectedNot connected or authorization revoked
errorConnection issue — try reconnecting

​
Select a Square location

After connecting, Crave fetches your Square locations. Select the one that corresponds to your Crave location:
  1. Go to Settings > Integrations > Square
  2. Choose from the dropdown of Square locations
  3. Click Save
Each Crave location maps to exactly one Square location.

​
Import your catalog

Once a Square location is selected, import the catalog:
  1. Click Import Catalog on the integration page
  2. Crave pulls all items, categories, and modifier groups from Square
  3. Review the imported data in the Menu Editor
Importing overwrites any existing menu data for this location. If you’ve made manual edits in Crave, export or note them before importing.

​
What gets imported

Square conceptCrave equivalent
ItemProduct
CategoryCategory
Modifier listModifier group
ModifierModifier item
VariationProduct variant (mapped to modifiers)
ImageProduct image

​
What does NOT sync

  • Pricing changes: Re-import to update prices from Square
  • Real-time inventory: Crave doesn’t track Square stock levels in real-time
  • Square discounts: Crave has its own discount system

​
Disconnect Square

To remove the integration:
  1. Go to Settings > Integrations > Square
  2. Click Disconnect
  3. Confirm the action
Disconnecting does NOT delete imported menu data. Your products, categories, and modifiers remain in Crave.

​
API reference

These admin endpoints power the Square integration:
MethodPathDescription
POST/locations/:id/integrations/square/oauthStart OAuth flow
GET/locations/:id/integrations/squareGet integration status
GET/locations/:id/integrations/square/locationsList Square locations
POST/locations/:id/integrations/square/locationsSet active location
POST/locations/:id/integrations/square/catalog/importImport catalog
DELETE/locations/:id/integrations/squareDisconnect

​
Troubleshooting

​
OAuth redirect fails

  • Ensure your browser allows popups/redirects from connect.squareup.com
  • Clear cookies and try again
  • If using a VPN, Square may block the connection — try without VPN

​
Import missing items

  • Verify items are published in your Square catalog (draft items are skipped)
  • Check that items have a price — priceless items cannot be imported
  • Re-run the import to pick up newly added items

Slack Community

Ask questions and get help from the Crave team and community.

Discord

Join our Discord server for real-time discussions.

Email Support

Reach out to hello@craveup.com for direct support.