# Loyalty & Referrals Documentation

> Build customized rewards & referrals programs to engage existing customers and reach new ones.

## Guides
- [Documentation](https://loyaltyapi.yotpo.com/docs.md): Loyalty & Referrals documentation

## API Reference
- [Welcome](https://loyaltyapi.yotpo.com/reference/welcome.md): Introduction to the Yotpo Loyalty API — integrate rewards, referrals, and customer incentives into your platform.
- [Authentication](https://loyaltyapi.yotpo.com/reference/authentication.md): How to authenticate with the Yotpo Loyalty API using your GUID and API key.
- [Guidelines & Conventions](https://loyaltyapi.yotpo.com/reference/guidelines-and-conventions.md): Best practices, rate limits, and usage patterns for the Yotpo Loyalty & Referrals API.
- [Create/Update Customer Records](https://loyaltyapi.yotpo.com/reference/createupdate-customer-records.md): This endpoint both creates and updates a customer’s record in the Yotpo system. Use this primarily to notify Yotpo when you add a customer manually in your admin, or a customer changes their email address.
- [Fetch Customer Details](https://loyaltyapi.yotpo.com/reference/fetch-customer-details.md): This endpoint returns a customer record. Most commonly used to fetch a customer’s point balance and unique referral link.
- [Create Order](https://loyaltyapi.yotpo.com/reference/create-order.md): This endpoint records an order made by a customer. It will apply the order to all matching active campaigns and award the necessary points and/or discounts.
- [Adjust a Customer's Point Balance](https://loyaltyapi.yotpo.com/reference/adjust-a-customers-point-balance.md)

## Changelog
- [`customer.points_expire_at` on loyalty webhook events](https://loyaltyapi.yotpo.com/changelog/customerpoints_expire_at-on-loyalty-webhook-events.md)
- [Welcome to Loyalty and Referrals](https://loyaltyapi.yotpo.com/changelog/welcome-to-loyalty-and-referrals.md)