Customer Tags

FullContact provides the ability to store, manage and extract by certain customer segments/tags. This feature allows customers tags to be stored within a customer’s Identity Streme for continuous updates, retrievals and deletes across both 1st party as well as 2nd party data partnerships.

By default, on all Resolve responses customer tags are disabled. Should you wish to enable this feature and have customer tags included you may include this as a query parameter in the Resolve request.

curl -X POST https://api.fullcontact.com/v3/identity.resolve?tags=true \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{
     "recordId": "customer123"
    }'

Create Tags

Once a Customer Record ID has been mapped customer tags can continue to be added to the originally provided Record ID.

curl -X POST https://api.fullcontact.com/v3/tags.create \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{
     "recordId": "customer123",
     "tags": [
         { "key" : "loyalty", "value" : "true" }
   ]
  }'

Get Tags

This endpoint will return all client-driven customer tags that have been previously associated with and mapped to an individual.

curl -X POST https://api.fullcontact.com/v3/tags.get \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{
     "recordId": "customer123"
  }'

{
     "tags": [
         { "key" : "segment", "value" : "highspender" },
         { "key" : "loyalty", "value" :  "true" },
         { "key" : "homepage", "value" : "true" }
   ]
}

Delete Tags

This endpoint will remove specific or all customer tags that are attached to an individual.

curl -X POST https://api.fullcontact.com/v3/tags.delete \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{
     "recordId": "customer123",
     "tags": [
         { "key" : "segment", "value" : "highspender" },
         { "key" : "segment", "value" :  "clothing" },
         { "key" : "homepage", "value" : "true" }
   ]
  }'

{
 "status": 204,
 "message": "No content"
}

📘
If you want to learn more about how storing and leveraging customer tags can help your business please contact our Sales team.