# Square

> Sync Square POS data — customers, catalog, orders, payments, refunds, invoices and more — into your Filament warehouse.

Square tracks your point of sale transactions and inventory, but understanding which products drive repeat purchases or how in-store sales correlate with your online marketing requires connecting to your email platform and advertising data.

Filament links Square to your other tools and answers questions about customer behaviour and campaign performance in plain English.

## Data we sync

- **Customers**: Track customer profiles with contact details, creation dates, lifetime value, and visit history. Analyse repeat purchase behaviour and customer segments across locations. (`id`, `email_address`, `created_at`, `total_spent`, `visit_count`)
- **Orders**: Track individual transactions with line items, payments, fulfillment status, and location data. Analyse sales patterns by time, location, and product mix. (`id`, `created_at`, `total_money`, `line_items`, `location_id`, `state`)
- **Payments**: Track payment transactions with processing fees, payment methods, and refund status. Calculate net revenue and analyse payment method preferences by customer segment. (`id`, `amount_money`, `processing_fee`, `payment_method`, `status`, `refunded_money`)
- **Catalog Items**: Track products with variations, modifiers, pricing, and category assignments. Analyse product performance and pricing strategies across locations. (`id`, `name`, `variations`, `category_id`, `item_data`)
- **Inventory**: Track stock levels, inventory adjustments, and transfers between locations. Monitor stock movement patterns and identify slow-moving or out-of-stock items. (`catalog_object_id`, `location_id`, `quantity`, `calculated_at`, `state`)
- **Refunds**: Track refunded transactions with reason codes, amounts, and associated payments. Analyse refund patterns by product, location, and time period. (`id`, `payment_id`, `amount_money`, `reason`, `created_at`)
- **Invoices**: Track invoiced sales with payment schedules, delivery methods, and customer details. Monitor outstanding invoices and payment collection rates. (`id`, `invoice_number`, `customer_id`, `payment_requests`, `status`, `created_at`)
- **Customer Groups**: Track customer segments with membership criteria and assigned customers. Analyse purchasing patterns and lifetime value by customer group. (`id`, `name`, `created_at`)

## How do I connect Square?

Use a Square account with permission to authorise access to your merchant data.

1. Open [Apps](https://filamentanalytics.com/apps) in Filament and add **Square**.
2. Sign in to Square and approve the requested permissions.
3. Review the connected merchant, add any useful context and complete setup.
