# Core API Documentation Documentation
> The Yotpo Core API lets you sync your store activity and related information to Yotpo, including orders, product catalog information, customers, and other store information required to configure Yotpo products.
## API Reference
- [Welcome](https://core-api.yotpo.com/reference/welcome.md)
- [How to use the Core API](https://core-api.yotpo.com/reference/how-to-use.md)
- [Guidelines & conventions](https://core-api.yotpo.com/reference/guidelines-and-conventions.md)
- [App key vs. Store ID](https://core-api.yotpo.com/reference/store-id-app-key.md): The Store ID (app key) and API secret are unique codes for your account.
- [Working with entity identifiers](https://core-api.yotpo.com/reference/working-with-entity-identifiers.md)
- [Working with custom properties](https://core-api.yotpo.com/reference/working-with-custom-properties.md)
- [About common objects](https://core-api.yotpo.com/reference/common-objects.md): These are common Core API objects used across multiple API operations.
- [Address](https://core-api.yotpo.com/reference/address.md)
- [Customer checkout information](https://core-api.yotpo.com/reference/customer-checkout-info.md): This information relates to the customer object used within the orders endpoints. It is not related to the customers endpoints.
- [GTIN](https://core-api.yotpo.com/reference/gtin.md): GTINs (Global trade item numbers, often called barcodes) are used to match products with external sources. A main use case for this is syndicating product reviews to other platforms or Google PLA. Each GTIN is specified using two fields. The `declared type` specifies the GTIN standard and the `value` fields holds the GTIN string value. A `detected_type` will be assigned to each GTIN based on the value format.
- [Line item](https://core-api.yotpo.com/reference/line-item.md)
- [About authentication](https://core-api.yotpo.com/reference/authentication.md): Yotpo uses tokens to authenticate and authorize an account. Tokens are generated by an API call that uses the store ID and client secret.
- [Generate Access Token](https://core-api.yotpo.com/reference/yotpo-authentication.md): This endpoint uses your Yotpo Store ID (app_key) and API secret to generate the API access token necessary to authenticate most of Yotpo's API calls. Learn how to find your store ID (app_key) and API secret in Finding your Yotpo app key and API secret.
- [About products](https://core-api.yotpo.com/reference/products.md): The Product entity allows you to keep your catalog in-sync with Yotpo. Product information is used by Yotpo to power various capabilities such as tagging photos to products, populating review-request emails with product information, and showing recommendations in the widgets.
- [Create product](https://core-api.yotpo.com/reference/create-product.md): Creates a new product within your product catalog.
- [Update product](https://core-api.yotpo.com/reference/update-product.md): Update the product information in Yotpo.
- [Retrieve products](https://core-api.yotpo.com/reference/retrieve-products.md): Retrieves a list of all of your store's products. You can use this endpoint to resolve the Yotpo product ID in order to update it.
- [Retrieve product by ID](https://core-api.yotpo.com/reference/retrieve-product-by-id.md): Retrieves all product information for a specific product using its Yotpo ID.
- [About orders](https://core-api.yotpo.com/reference/orders.md): Sync your store orders to Yotpo.
- [Create order](https://core-api.yotpo.com/reference/create-order.md): Creates an order in your Yotpo store. Is not possible to send automatic review request emails for orders that are older than six months.
- [Update order](https://core-api.yotpo.com/reference/update-order.md): Updates an order in your Yotpo store.
- [Retrieve orders](https://core-api.yotpo.com/reference/retrieve-orders.md): Retrieves a list of orders for your Yotpo store.
- [Retrieve order by ID](https://core-api.yotpo.com/reference/retrieve-order-by-id.md): Retrieves all of the details of a specific order using its Yotpo ID.
- [About order fulfillments](https://core-api.yotpo.com/reference/order-fulfillments.md): Sync your store order fulfillments to Yotpo. Order fulfillments represent a group of one or more items in an order that are to be fulfilled from the same location. A fulfillment represents work that is completed as part of a fulfillment order and can include one or more items.
- [Create order fulfillment](https://core-api.yotpo.com/reference/create-order-fulfillment.md): Creates an order fulfillment in your Yotpo store.
- [Update order fulfillment](https://core-api.yotpo.com/reference/update-order-fulfillment.md): Updates an order fulfillment in your Yotpo store.
- [Retrieve order fulfillments](https://core-api.yotpo.com/reference/retrieve-order-fulfillments.md): Retrieves a list of fulfillments for an order in your Yotpo store.
- [Retrieve fulfillment by ID](https://core-api.yotpo.com/reference/retrieve-fulfillment-by-id.md): Retrieves all fulfillments for a specific order using its Yotpo ID.
- [About aggregated order info](https://core-api.yotpo.com/reference/aggregated-order-info.md): In order to send Yotpo all relevant information regarding the order in one batch, you can use the Register purchase endpoint. This endpoint takes in the payloads of an order along with its product and fulfillment information. **We recommend using this endpoint for simple integrations. If you want to gain more control over the data synced to Yotpo, you should use our RESTful API.**
- [Send aggregated order info](https://core-api.yotpo.com/reference/send-aggregated-order-info.md): Sends all relevant order information to Yotpo in one batch.
- [About Webhooks](https://core-api.yotpo.com/reference/about-webhook-events.md)
- [Topics](https://core-api.yotpo.com/reference/topics.md)
- [Create target](https://core-api.yotpo.com/reference/create-target.md): Creates a webhook target or callback URL for listening to events. The webhook target can be used to listen to multiple events from multiple accounts.
- [Retrieve targets](https://core-api.yotpo.com/reference/retrieve-targets.md): Retrieves a list of all of your webhook targets.
- [Retrieve target by ID](https://core-api.yotpo.com/reference/retrieve-target-by-id.md): Retrieves a webhook target using its Yotpo ID.
- [Update target](https://core-api.yotpo.com/reference/update-target.md): Updates a webhook target. This webhook target can be used for listening to multiple events from multiple accounts.
- [Delete target](https://core-api.yotpo.com/reference/delete-target.md): Deletes a webhook target. This webhook target can be used for listening to multiple events from multiple accounts, and so only unused webhook targets can be deleted.
- [Create filter](https://core-api.yotpo.com/reference/create-filter.md): Create a webhook filter. This webhook filter can be used with multiple webhook targets. An event type cannot be used twice in the same webhook filter.
- [Retrieve filters](https://core-api.yotpo.com/reference/retrieve-filters.md): Retrieves a list of all of your webhook filters.
- [Retrieve filter by ID](https://core-api.yotpo.com/reference/retrieve-filter-by-id.md): Retrieves a webhook filter using its Yotpo ID.
- [Update filter](https://core-api.yotpo.com/reference/update-filter.md): Updates a webhook filter. This webhook filter can be used with multiple webhook targets.
- [Delete filter](https://core-api.yotpo.com/reference/delete-filter.md): Deletes a webhook filter. This webhook filter can be used with multiple webhook targets, so only unused webhook filters can be deleted.
- [Create subscription](https://core-api.yotpo.com/reference/create-subscription.md): Combine the target and filter to create a subscription.
- [Retrieve subscriptions](https://core-api.yotpo.com/reference/retrieve-subscriptions.md): Retrieves a list of all of your webhook subscriptions.
- [Retrieve subscription by ID](https://core-api.yotpo.com/reference/retrieve-subscription-by-id.md): Retrieves a webhook subscription using its Yotpo ID.
- [Update subscription](https://core-api.yotpo.com/reference/update-subscription.md): Updates a webhook subscription.
- [Delete subscription](https://core-api.yotpo.com/reference/delete-subscription.md): Deletes a webhook subscription.
- [About product variants](https://core-api.yotpo.com/reference/product-variants.md): Sync your product variants to Yotpo. Add variants to your products in order to represent one version of a product with several options, for example, size, or color. Each product will have a variant for every possible combination of its options.
- [Create product variant](https://core-api.yotpo.com/reference/create-product-variant.md): Creates a new product variant within your product catalog.
- [Update product variant](https://core-api.yotpo.com/reference/update-product-variant.md): Updates a product variant within your product catalog.
- [Retrieve product variants](https://core-api.yotpo.com/reference/retrieve-product-variants.md): Retrieves a list of product variants within your product catalog.
- [Retrieve product variant by ID](https://core-api.yotpo.com/reference/retrieve-product-variant-by-id.md): Retrieves a product variant by store ID, product ID, and product variant ID.
- [About collections](https://core-api.yotpo.com/reference/collections.md): Sync your product collections to Yotpo. A collection is a grouping of products that you can use to make your store easier to browse. For example, you might use collections to group items of a certain type such as footwear, seasonal items such as greetings cards, or items on sale.
- [Create collection](https://core-api.yotpo.com/reference/create-collection.md): Creates a new collection within your product catalog.
- [Update collection](https://core-api.yotpo.com/reference/update-collection.md): Updates a collection within your product catalog.
- [Retrieve collections](https://core-api.yotpo.com/reference/retrieve-collections.md): Retrieves a list of all of your store's collections.
- [Add product to collection](https://core-api.yotpo.com/reference/add-product-to-collection.md): Adds a product to a collection within your product catalog.
- [Retrieve products in collection](https://core-api.yotpo.com/reference/retrieve-products-in-collection.md): Retrieves a paginated list of products from a collection in your product catalog.
- [Remove product from collection](https://core-api.yotpo.com/reference/remove-product-from-collection.md): Removes a product from a collection within your product catalog.
- [Retrieve list of collections for product](https://core-api.yotpo.com/reference/retrieve-list-of-collections-for-product.md): Retrieves a paginated list of collections within your product catalog that a product belongs to.
- [About customers](https://core-api.yotpo.com/reference/customers.md): Sync your store customers to Yotpo, to be used as contacts for messaging. This includes information about your shop's customers such as their contact details, their order history, and whether they've agreed to receive marketing messaging.
- [Create or update customer](https://core-api.yotpo.com/reference/create-customer.md): Creates a customer in your Yotpo store.
- [Retrieve customers](https://core-api.yotpo.com/reference/retrieve-customers.md): Retrieves a list of past and existing customers from your Yotpo store. Use this endpoint to check if a customer was registered successfully with Yotpo.
## Changelog
- [Tier Expiration Reminder webhook event](https://core-api.yotpo.com/changelog/tier-expiration-reminder-webhook-event.md)
- [`customer.points_expire_at` on loyalty webhook events](https://core-api.yotpo.com/changelog/customerpoints_expire_at-on-loyalty-webhook-events.md)
- [Changelog](https://core-api.yotpo.com/changelog/welcome-to-yotpo.md)