In this document, we will walk through all the ways you can use the personalization API to sync audiences, warehouse data, or real-time signals for personalization.

Setup Destination

First, add a new personalization destination in the destinations page. This will allow you to send any of the GrowthLoop products to the personalization api.

Setup a Sync

Next, you can set up a sync of profile attributes you want to always be available for personalization from your data warehouse.

Export audience to Personalization API

By exporting audiences to the personalization API, you can personalize the experience for users who belong to specific audiences.

Journeys to Personalization API

You can also build complex workflows and lifecycle campaigns to test or drive users to personalziation API, e.g., with different offers.

Fetch Profile

After you've done all those steps, or some of them. This is how you can fetch the profile and what it will look like.

curl -X GET "https://segments.growthloop.com/v1/entities/users/user001" \
  -H "Authorization: Bearer YOUR_PERSONALIZATION_API_KEY" \
  -H "Content-Type: application/json"

Below is a response with all the attributes we set up above:

{
    "contact_lens_user": true,
    "email_engagnement_level": "HIGH",
    "audiences": {
        "32142": {
            "audience_name": "High Value Churn Users",
        },
    },
    "entity_id": "user_001",
    "entity_name": "customers",
    "offer": "5%",
}