Customer Tags

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 Private Identity Cloud 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"
}

Audience Tags

Customers can use these endpoints in order to obtain multiple individuals based upon the key, value tag inputs (both are required as input) in order to suppress or take action upon certain audiences for data onboarding or audience analysis. Any newly created tags will not be available to use for audience creation for approximately 24hrs.

The Audience Creation endpoint requires a valid webhook URL to be present in order to send a message when the audience creation is complete and ready to be downloaded.

The output of the Audience Download endpoint will contain FullContact PIDs, Hashed Emails and MAIDs based upon the input tag filters separated out by 1st Party and 2nd Party Data partners if participating in Private Identity Sharing. A customer will receive this output as part of a JSON Gzip response within 24hrs. Should you want to learn more about obtaining 2nd Party Data check out Private Identity Sharing

curl -X POST https://api.fullcontact.com/v3/audience.create \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{
     "webhookUrl":"http://www.fullcontact.com/hook",
     "tags": [
         { "key" : "segment", "value" : "highspender" },
         { "key" : "homepage", "value" : "true" }
   ]
  }'
{
    "result": {
        "message": "The Audience Query was completed successfully\n\nPlease download the result from https://api.fullcontact.com/v3/audience.download?requestId=97b7d8b1-757b-4400-8846-0ec47e8f8f56\nThe query result will be available for 30 days for download.\nFullContact Audience Team",
        "downloadUrl": "https://api.fullcontact.com/v3/audience.download?requestId=97b7d8b1-757b-4400-8846-0ec47e8f8f56"
    },
    "webhookId": "89aba154-22fb-42fc-a836-b98f5b4e74b7"
}

Audience Download

curl https://api.fullcontact.com/v3/audience.download?requestId=97b7d8b1-757b-4400-8846-0ec47e8f8f56

📘

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