{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Audience Studio","type":"markdown"},"seo":{"title":"Create a Profiles API Token","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-a-profiles-api-token","__idx":0},"children":["Create a Profiles API Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ability to create a Profiles API token is based on your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/control-panel/security/policies/setting-policy-based-audience-studio-permissions-using-td-console"},"children":["folder permissions"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This topic includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#name-your-new-token"},"children":["Name Your New Token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#configure-the-token"},"children":["Configure the Token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#add-segments-to-the-token"},"children":["Add Segments to the Token"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"name-your-new-token","__idx":1},"children":["Name Your New Token"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Treasure Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to Audience Studio and select a segment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a folder."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select Create New."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select Profiles API Token."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-9-16_17-44-38.27bf44443534e74fec62e9dea8f3806a9713f60777e904c854c711c29c2bb2bd.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a name for your token and optionally enter a description. Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-the-token","__idx":2},"children":["Configure the Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The name and description carry over from when you named the token. You can make changes."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a Lookup Key."," ","A Lookup Key is a column with a unique value inside the Parent segment. This key identifies the correct profile."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The lookup key update will take effect once the token workflow finishes. When using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]}," as the lookup key, the Profiles API retrieves the lookup value from the browser cookie instead of the API request's query param. For testing or verification purposes outside of a browser (eg, Postman), use a different column to pass in the lookup value manually."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Enter a maximum of five attributes."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-10-6_11-52-55.ae742b08d8a5b24f0ff091fa9c1811086b50a566fea779f2b0eba21a1cb271b7.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose one of the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," to continue and add segments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}," to configure the token. (You can add segments later if you want.)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-9-23_8-23-11.0bc50657990a3ca0813f1e0f64e13165abf48bc27cd931896ee2d0e91ee31f6d.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-segments-to-the-token","__idx":3},"children":["Add Segments to the Token"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose one of the following:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After you configure your token, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to Audience Studio > Folder > Profiles API Token."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-9-16_19-20-53.1dfd3888b64889cd13d9757c91f00754f50958ab69779eeca4bd0fbbf6cfee3f.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add up to 15 Segments to your Profiles API Token."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-9-22_14-41-40.e8ee7338f54a6d32f9131e16aa3f946d7072bc0a6dda2c4208da7a89440c7fa9.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-9-22_14-43-7.d7e88b729f3a5421c4fcb792598766ca879e2c859d7b807557ca135190d96543.cf3845cb.png","alt":""},"children":[]}]}]},"headings":[{"value":"Create a Profiles API Token","id":"create-a-profiles-api-token","depth":1},{"value":"Name Your New Token","id":"name-your-new-token","depth":2},{"value":"Configure the Token","id":"configure-the-token","depth":2},{"value":"Add Segments to the Token","id":"add-segments-to-the-token","depth":2}],"frontmatter":{"seo":{"title":"Create a Profiles API Token"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/audience-studio/profiles/create-a-profiles-api-token","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}