# Personalization Documentation > The official developer documentation for Fresh Relevance. ## Guides - [Get started](https://personalization.developer.dotdigital.com/docs/getting-started.md): Get up and running with Dotdigital Personalization APIs. - [Dotdigital Personalization system overview](https://personalization.developer.dotdigital.com/docs/fresh-relevance-system-overview.md): An introduction to what the platform can do and how it works. - [Key concepts](https://personalization.developer.dotdigital.com/docs/key-concepts.md): A good understanding of the following key concepts is crucial when working with Dotdigital Personalization, as they are used throughout the platform and APIs. - [Install the tracking script](https://personalization.developer.dotdigital.com/docs/tracking-script.md) - [Install with Google Tag Manager](https://personalization.developer.dotdigital.com/docs/install-with-google-tag-manager.md) - [Install with Tealium Tag Manager](https://personalization.developer.dotdigital.com/docs/install-with-tealium-tag-manager.md): The Personalization script can be added to your website using Tealium Tag Manager and other tag management systems. - [Install with Adobe Tag Manager](https://personalization.developer.dotdigital.com/docs/install-with-adobe-tag-manager.md): The Personalization script can be added to your website using Adobe Dynamic Tag Manager. - [Test your website integration](https://personalization.developer.dotdigital.com/docs/test-your-website-integration.md) - [Ignore development and test environments](https://personalization.developer.dotdigital.com/docs/ignoring-development-and-test.md) - [Create and edit API access tokens](https://personalization.developer.dotdigital.com/docs/create-and-edit-api-access-tokens.md): Create and manage the tokens needed to use the Personalization REST API and KPI widgets securely. - [Additional data capture](https://personalization.developer.dotdigital.com/docs/additional-data-capture.md) - [Mobile Apps and PWA](https://personalization.developer.dotdigital.com/docs/mobile-apps-and-pwa.md): Understand how you can integrate Dotdigital Personalization into your native mobile apps and PWAs - [Identify more visitors](https://personalization.developer.dotdigital.com/docs/identify-more-visitors.md) - [Payment gateways](https://personalization.developer.dotdigital.com/docs/payment-gateways.md) - [The Personalization SDK](https://personalization.developer.dotdigital.com/docs/the-fresh-relevance-sdk.md): The Personalization software development kit (SDK) is a set of tools designed to give you full control over how your website integrates with Dotdigital Personalization. - [Personalization SDK: Dotdigital Tag API methods](https://personalization.developer.dotdigital.com/docs/fresh-relevance-sdk-dotdigital-tag-api-methods.md) - [Custom event examples](https://personalization.developer.dotdigital.com/docs/custom-event-examples.md): With the Dotdigital Tag, in addition to standard page tracking, product browsing, and cart and checkout processes, you can also track custom events. - [Adobe Commerce/Magento 2](https://personalization.developer.dotdigital.com/docs/adobe-commerce-magento-2.md): There are two extensions available for your Adobe Commerce/Magento store to help you get up and running with integrating Personalization. - [HTML API overview](https://personalization.developer.dotdigital.com/docs/html-api-overview.md): The HTML API allows you to pass information from your cart page or other web page to Dotdigital Personalization. - [Microdata - Rich snippets](https://personalization.developer.dotdigital.com/docs/microdata-rich-snippets.md) - [Web Analytics](https://personalization.developer.dotdigital.com/docs/web-analytics.md) - [W3C DDL (Digital Data Layer)](https://personalization.developer.dotdigital.com/docs/w3c-ddl-digital-data-layer.md) - [Personalized content overview](https://personalization.developer.dotdigital.com/docs/personalization-overview.md): Dotdigital Personalization Slots are used to personalize a web page or email. - [Client-side personalization](https://personalization.developer.dotdigital.com/docs/clientside-personalization.md) - [Using custom HTML](https://personalization.developer.dotdigital.com/docs/using-custom-html-1.md): Build your own HTML: Click tracking client-side helper. - [Server-side personalization](https://personalization.developer.dotdigital.com/docs/server-side-personalization.md) - [Fetch personalized HTML](https://personalization.developer.dotdigital.com/docs/fetching-personalized-html.md) - [Use Experiences](https://personalization.developer.dotdigital.com/docs/using-experiences.md): Use Experiences with server-side personalization. - [Use custom HTML](https://personalization.developer.dotdigital.com/docs/using-custom-html.md): Build your own HTML: how to add link tracking to enable reporting. - [Server-side / PWA Activity Tracking](https://personalization.developer.dotdigital.com/docs/server-side-pwa-activity-tracking.md) - [Purchase complete tracking](https://personalization.developer.dotdigital.com/docs/purchase-complete-tracking.md) ## API Reference - [Downloading OAS / Swagger specifications](https://personalization.developer.dotdigital.com/reference/downloading-oas-swagger-specifications.md) - [Accounts API](https://personalization.developer.dotdigital.com/reference/accounts-api.md) - [Get account information](https://personalization.developer.dotdigital.com/reference/getaccountinfo.md): Retrieves the Dotdigital Personalization account information for the website. - [Get client information](https://personalization.developer.dotdigital.com/reference/getclientinfo.md): Retrieves the Dotdigital Personalization client information for the requesting account and website. - [Update client information](https://personalization.developer.dotdigital.com/reference/putupdateclientinfo.md): Updates the Dotdigital Personalization client information for the requesting account and website. - [Get admin users](https://personalization.developer.dotdigital.com/reference/getadminusers.md): Retrieves limited details about Dotdigital Personalization admin users. - [Update admin user](https://personalization.developer.dotdigital.com/reference/putupdateadminuser.md): Updates an admin users details. - [Get channels](https://personalization.developer.dotdigital.com/reference/getchannels.md): Retrieves the configured channels for the account. - [Get channels](https://personalization.developer.dotdigital.com/reference/getchannel-1.md): Retrieves the details for a specified channel. - [Get categories](https://personalization.developer.dotdigital.com/reference/getcategories.md): Retrieves the configured categories for the account. - [Activity API](https://personalization.developer.dotdigital.com/reference/activity-api.md) - [Retrieve a specific experience.](https://personalization.developer.dotdigital.com/reference/getexperience.md): Retrieve a specific experience used on a page, which then can be used to perform custom server-side personalization. - [Channels API](https://personalization.developer.dotdigital.com/reference/channels-api.md) - [List channels](https://personalization.developer.dotdigital.com/reference/getlistchannels.md): Retrieves a list of channels for the website/account. - [Get channel](https://personalization.developer.dotdigital.com/reference/getchannel.md): Retrieves the details of a channel for the website/account. - [Content API](https://personalization.developer.dotdigital.com/reference/content-api.md) - [List slots for a page](https://personalization.developer.dotdigital.com/reference/getcampaigns.md): Retrieve a list of slots used on a page, which then can be used to perform custom server-side personalization. Example: `` - [Retrieve a slot](https://personalization.developer.dotdigital.com/reference/getslot.md): Retrieves the content of a slot, which then can be used to perform custom server-side personalization. - [Retrieve multiple slots](https://personalization.developer.dotdigital.com/reference/getmultislots.md): Retrieves the content of multiple slots at once, which then can be used to perform custom server-side personalization at scale. - [Track a click through](https://personalization.developer.dotdigital.com/reference/gettrackclickthrough.md): This call is used to track click throughs when using custom HTML in personalization. - [Data tables API](https://personalization.developer.dotdigital.com/reference/datatables-api.md) - [List Custom Data Tables](https://personalization.developer.dotdigital.com/reference/getlisttables.md): Lists all the Custom Data Tables in the current account. - [Creates Custom Data Table](https://personalization.developer.dotdigital.com/reference/postcreatetable.md): Creates a new, empty Custom Data Table. - [Validate table identifier](https://personalization.developer.dotdigital.com/reference/postvalidateidentifier.md): Ensures that the provided `tableId` is valid. - [Get logs for table](https://personalization.developer.dotdigital.com/reference/getgettablelogs.md): Returns all the logs from channels to do with the specified Custom Data Table. - [Gets a Custom Data Table.](https://personalization.developer.dotdigital.com/reference/getgettable.md): Gets the complete information for a single Custom Data Table. - [Updates Custom Data Table](https://personalization.developer.dotdigital.com/reference/putupdatetable.md): Updates basic information and the fields associated with a specific Custom Data Table. When updating fields, this is a complete state transfer, so you must include all fields in this request. Any new fields included will be created. Any existing fields not included will be deleted. Fields will be matched on `fieldId`. If you do not include any of `name`, `archived`, or `fields` in the request then they won't be updated. - [Gets JSON schema for table](https://personalization.developer.dotdigital.com/reference/getgettableschema.md) - [Get data from a table](https://personalization.developer.dotdigital.com/reference/getgettabledata.md) - [Export the data from table](https://personalization.developer.dotdigital.com/reference/postexporttabledata.md): Triggers the generation of a downloadable file containing the entire contents of the Custom Data Table. - [Gets channels for table](https://personalization.developer.dotdigital.com/reference/getgettablechannels.md): Lists all the channels for this specific Custom Data Table. - [Update or delete a channel for a table](https://personalization.developer.dotdigital.com/reference/putupdatetablechannel.md): Modifies a channel for the specified Custom Data Table. If you wish to delete a channel, set `active` to `false`. - [Creates a channel for table](https://personalization.developer.dotdigital.com/reference/postcreatetablechannel.md): Creates a channel for this specific Custom Data Table. - [Get channel for table](https://personalization.developer.dotdigital.com/reference/getgettablechannel.md): Gets a specific channel for the specified Custom Data Table. - [Folders API](https://personalization.developer.dotdigital.com/reference/folders-api.md) - [Get all folders](https://personalization.developer.dotdigital.com/reference/folders_list_all.md): All content folders in JSON format. - [Create folder](https://personalization.developer.dotdigital.com/reference/folders_create.md): Create a new folder. - [Get folder](https://personalization.developer.dotdigital.com/reference/folders_get.md): Get a content folders details in JSON format. - [Update folder](https://personalization.developer.dotdigital.com/reference/folders_update.md): Updates the name of a folder. - [Delete folder](https://personalization.developer.dotdigital.com/reference/folders_delete.md): Deletes the specified folder. - [JavaScript API overview](https://personalization.developer.dotdigital.com/reference/js-overview.md): Pass data to Dotdigital Personalization with JavaScript. - [Calls](https://personalization.developer.dotdigital.com/reference/js-calls.md): Calls and functions available in the Dotdigital Personalization JavaScript API - [Events](https://personalization.developer.dotdigital.com/reference/js-events.md) - [Raising events](https://personalization.developer.dotdigital.com/reference/raising-events.md): Events need to be raised in your app so that Dotdigital Personalization can track and understand your users' behavior. - [Consuming events](https://personalization.developer.dotdigital.com/reference/consuming-events.md): Allows you to listen for events raised by Dotdigital Personalization when capturing information from your website. - [Hooks](https://personalization.developer.dotdigital.com/reference/hooks.md) - [Mobile Data Collection API](https://personalization.developer.dotdigital.com/reference/mobile-data-collection-api.md) - [Record Activity](https://personalization.developer.dotdigital.com/reference/record_activity.md): POSTs will be immediatelty acknowledged with a 204 if the POST is successfully received and the JSON decoded. Data errors within the JSON will not be acknowledged on this endpoint, but will be handled gracefully where possible. Note the User Agent "ua" field should be accurate, as it is used to determine the form-factor & OS for analytics purposes. - [Record Activity - Validation Endpoint](https://personalization.developer.dotdigital.com/reference/record_activity_validation.md): **(Not for regular production use)**
This call alllows you to validate your record activity calls at development time and get detailed feedback of any issues. The payload will be validated against expectations. If there are no issues found, a 200 will be returned. If any errors are found, a 422 Unprocessable Entity will be returned, with a JSON array of errors in the body. - [Layouts API](https://personalization.developer.dotdigital.com/reference/layouts-api.md): To personalize a web page or email, layouts are used. Each layout is a block of HTML content and can be used on either in a web page or an email. - [List layouts](https://personalization.developer.dotdigital.com/reference/getlistlayouts.md): Retrieves layouts using the specified filters. - [Create layout](https://personalization.developer.dotdigital.com/reference/postcreatelayout.md): Creates a new layout. - [Get layout](https://personalization.developer.dotdigital.com/reference/getlayout.md): Retrieves a layouts details. - [Update layout](https://personalization.developer.dotdigital.com/reference/postupdatelayout.md): Updates a layout. - [Delete layout](https://personalization.developer.dotdigital.com/reference/dellayout.md): Deletes a layout. - [Clone layout](https://personalization.developer.dotdigital.com/reference/postclonelayout.md): Clones a layout. - [Bulk update layout](https://personalization.developer.dotdigital.com/reference/postbulkupdatelayout.md): Updates multiple layouts with the same details. - [Bulk delete layouts](https://personalization.developer.dotdigital.com/reference/delbulklayout.md): Deletes multiple layouts. - [People API](https://personalization.developer.dotdigital.com/reference/people-api.md) - [List people](https://personalization.developer.dotdigital.com/reference/getlistpeople.md): Retrieves a list of people. - [Search people](https://personalization.developer.dotdigital.com/reference/getsearchpeople.md): Searches the list of people based on your criteria and returns their people ids if found. - [Get person](https://personalization.developer.dotdigital.com/reference/getgetperson.md): Retrieves a persons details. - [Update person](https://personalization.developer.dotdigital.com/reference/putupdateperson.md): Updates a persons details. - [Delete person](https://personalization.developer.dotdigital.com/reference/deldeleteperson.md): Deletes a person. - [Import product data](https://personalization.developer.dotdigital.com/reference/importing-product-data.md) - [Access the Products API](https://personalization.developer.dotdigital.com/reference/accessing-the-integration-api.md) - [Field mapping and data](https://personalization.developer.dotdigital.com/reference/field-mapping-and-data.md): Set up field mapping for product data imports - [Get products.](https://personalization.developer.dotdigital.com/reference/getproducts.md): Retrieves the products from Dotdigital Personalization. - [Search products.](https://personalization.developer.dotdigital.com/reference/getsearchproducts.md): Searches the products in Dotdigital Personalization based on your criteria. - [Product Import](https://personalization.developer.dotdigital.com/reference/post_api-website-id-products-import.md): Import Products into the Dotdigital Personalization system by adding products to the Product Import Engine Queue. This is an asychronous call and will only queue the products for import. The actual creation / update of products will occur asynchronously after the request has been processed. The time for products to be imported will depend on the number of products, but you should see products start to appear in your Dotdigital Personalization account within a minute or so. *Note: Maximum rquest size in 5MB* - [Get product history.](https://personalization.developer.dotdigital.com/reference/getproducthistory.md): Retrieves the product history as a set of records describing when the record last changes and the value and stock level. - [Get daily product analytics](https://personalization.developer.dotdigital.com/reference/getdailyproductanalytics.md): Retrieves the product analytics summarized on a daily basis for the specified filter criteria. - [Get aggregated product analytics](https://personalization.developer.dotdigital.com/reference/getaggregatedproductanalytics.md): Retrieves an aggregation of product analytics daily records over the given date range.
*Note: due to database constraints, there is a maximum limit value of 100,000 and results are sorted by bq (browsed quantity).* - [Purchases API](https://personalization.developer.dotdigital.com/reference/purchases-api.md) - [Mark a purchase as complete](https://personalization.developer.dotdigital.com/reference/getpurchasecomplete.md): Marks a purchase as complete from the server side if not using the usual client side tracking pixels. - [Reports API](https://personalization.developer.dotdigital.com/reference/reports-api.md): The Reports API is a REST API that allows you to access reports about how Dotdigital Personalization is performing. - [Campaigns summary report](https://personalization.developer.dotdigital.com/reference/getcampaignsreport.md): Retrieves a summary report of campaings executed in the given time range for the requesting account and website. Note the system uses next day attribution to collate this data. - [Campaigns details report](https://personalization.developer.dotdigital.com/reference/getcampaignsdetailsreport.md): Retrieves details each conversion campaigns have generated in the given time range for the requesting account and website. Note the system uses click attribution to collate this data. - [Conversions report](https://personalization.developer.dotdigital.com/reference/getconversionsreport.md): Retrieves a daily summary report of conversions in the given time range for the requesting account and website. - [Abandoned carts report](https://personalization.developer.dotdigital.com/reference/getabandonedcarts.md): Retrieves a report of any abandoned carts that match the specified filters. - [Recovered carts report](https://personalization.developer.dotdigital.com/reference/getrecoveredcarts.md): Retrieves a report of any recovered carts that match the specified filters. - [Purchased carts report](https://personalization.developer.dotdigital.com/reference/getpurchasedcarts.md): Retrieves a report of any purchased carts that match the specified filters. - [Carted report](https://personalization.developer.dotdigital.com/reference/getcarted.md): Retrieves a report of any carted products that match the specified filters. - [Messages sent report](https://personalization.developer.dotdigital.com/reference/getmessagessent.md): Retrieves a report of any messages sent that match the specified filters. - [Unsubscribes report](https://personalization.developer.dotdigital.com/reference/getunsubscribes.md): Retrieves a report of any unsubscribes from marketing that match the specified filters. - [Summary report](https://personalization.developer.dotdigital.com/reference/getsummary.md): Retrieves a report of key performance metrics that match the specified filters. Defaults to last day if no `date_start` is passed. - [Summary outline](https://personalization.developer.dotdigital.com/reference/getoutline.md): Retrieves a more detailed outline summary report of key performance metrics that match the specified filters. Defaults to last day if no `date_start` is passed. - [Usage summary](https://personalization.developer.dotdigital.com/reference/getusage.md): Retrieves a usage report for the specified date range and the current and previous billing month. Defaults to a date range of the last day if no `date_start` is passed. - [Get overview report](https://personalization.developer.dotdigital.com/reference/getoverviewreport.md): Retrieves an overview of the usage and analytics for a entity type for the specified filter criteria. - [Get overview report](https://personalization.developer.dotdigital.com/reference/getoverviewreportforitem.md): Retrieves an overview of the usage and analytics for a entity type and specific item(s) for the specified filter criteria. - [Get analytics report](https://personalization.developer.dotdigital.com/reference/getanalyticsreport.md): Retrieves an analytics report for a entity type for the specified filter criteria. - [Get analytics report for item(s)](https://personalization.developer.dotdigital.com/reference/getanalyticsreportforitem.md): Retrieves an analytics report for a entity type and specific item(s) for the specified filter criteria. - [Slots API](https://personalization.developer.dotdigital.com/reference/slots-api.md) - [List slots](https://personalization.developer.dotdigital.com/reference/getlistslots.md): Retrieves a list of the slots. - [Create slot](https://personalization.developer.dotdigital.com/reference/postcreateslot.md): Creates a new slot. - [Get slot](https://personalization.developer.dotdigital.com/reference/getgetslot.md): Gets the specified slot details. - [Update slot](https://personalization.developer.dotdigital.com/reference/postupdateslot.md): Updates a slot and returns the updated slot details. - [Delete slot](https://personalization.developer.dotdigital.com/reference/deldeleteslot.md): Deletes the specified slot. - [Clone slot](https://personalization.developer.dotdigital.com/reference/postcloneslot.md): Clones a slot and returns the cloned slot details. - [Bulk update slots](https://personalization.developer.dotdigital.com/reference/postbulkupdateslots.md): Allows multiple slots to be edited at once for example, to update the folder id of multiple slots. This API supports updating the `folder_id`, `locked` and `active` fields only. The `active` field should be set to `true` to undelete the slots. - [Bulk delete slots](https://personalization.developer.dotdigital.com/reference/delbulkdeleteslots.md): Allows multiple slots to be deleted at once. - [SmartBlocks API](https://personalization.developer.dotdigital.com/reference/smartblocks-api.md): The SmartBlocks API is a REST API that allows you to access and create SmartBlocks from your systems in order to automate content generation and provide hyper-personalization. - [Get Smartblocks](https://personalization.developer.dotdigital.com/reference/smartblocks_list_all.md): Retrieves the Smartblocks for the website in JSON format. - [Create Smartblock](https://personalization.developer.dotdigital.com/reference/smartblocks_create.md): Creates a Smartblock. - [Get Smartblock](https://personalization.developer.dotdigital.com/reference/smartblocks_retrieve.md): Retrieves details of an individual Smartblock - [Update Smartblock](https://personalization.developer.dotdigital.com/reference/smartblocks_update.md): Updates a Smartblock - [Delete Smartblock](https://personalization.developer.dotdigital.com/reference/smartblocks_delete.md): Deletes a Smartblock - [Bulk update Smartblocks](https://personalization.developer.dotdigital.com/reference/smartblocks_bulk_update.md): Allows multiple SmartBlocks to be edited at once for example, to update the folder id of multiple SmartBlocks. This API supports updating the `folder_id`, `locked` and `active` fields only. The `active` field should be set to `true` to undelete the SmartBlocks. - [Bulk delete Smartblocks](https://personalization.developer.dotdigital.com/reference/smartblocks_bulk_delete.md): Deletes mulitple Smartblocks at once. - [Clone Smartblock](https://personalization.developer.dotdigital.com/reference/smartblocks_clone.md): Clones a Smartblock. - [Statistics](https://personalization.developer.dotdigital.com/reference/statistics.md): The Statistics API is a REST API that allows you to access statistics about how Dotdigital Personalization is performing. - [Get aggregated statistics](https://personalization.developer.dotdigital.com/reference/statistics_get.md): This API endpoint returns the requested aggregated statistics for the Dotdigital Personalization system which allows you to see how Dotdigital Personalization is performing. - [Get Smartblock statistics](https://personalization.developer.dotdigital.com/reference/statisticssmartblocksget.md): This API endpoint returns the requested information and statistics for all Smartblocks. When filtered it will return the requested information and statistics for Smartblocks matching the filters. - [Get Slot statistics](https://personalization.developer.dotdigital.com/reference/statisticsslotsget.md): This API endpoint returns the requested information and statistics for all Slots. When filtered it will return the requested information and statistics for Slots matching the filters. - [Get Triggers statistics](https://personalization.developer.dotdigital.com/reference/statisticstriggersget.md): This API endpoint returns the requested information and statistics for all Triggers. When filtered it will return the requested information and statistics for Slots matching the filters. - [Get Experiences statistics](https://personalization.developer.dotdigital.com/reference/statisticsexperiencesget.md): This API endpoint returns the requested information and statistics for all Experiences. When filtered it will return the requested information and statistics for Experiences matching the filters. - [Triggers API](https://personalization.developer.dotdigital.com/reference/triggers-api.md): The Triggers API is a REST API that allows you to retrieve and update program triggers. - [Lists program triggers](https://personalization.developer.dotdigital.com/reference/getlisttriggers.md): Retrieves a list of program triggers for the requesting account and website. - [Get trigger](https://personalization.developer.dotdigital.com/reference/gettrigger.md): Retrieves a program triggers details. - [Update trigger](https://personalization.developer.dotdigital.com/reference/putupdatetrigger.md): Updates a program triggers details. - [Delete trigger](https://personalization.developer.dotdigital.com/reference/deldeletetrigger.md): Deletes a program trigger, set `active` to `false`. - [Clone trigger](https://personalization.developer.dotdigital.com/reference/postclonetrigger.md): Clones a program triggers details. - [List trigger actions](https://personalization.developer.dotdigital.com/reference/gettriggeractions.md): Retrieves a list of program triggers actions. - [List trigger rules](https://personalization.developer.dotdigital.com/reference/getlisttriggerrules.md): Retrieves a list of trigger rules for the requesting account and website. - [Get trigger rule](https://personalization.developer.dotdigital.com/reference/gettriggerrule.md): Retrieves a trigger rules details. - [List trigger queue](https://personalization.developer.dotdigital.com/reference/getlisttriggerqueue.md): Retrieves a list of triggers that are queued for execution for the requesting account and website. - [Person fields](https://personalization.developer.dotdigital.com/reference/person-fields.md)