Loading
Salesforce Enforces New Security Requirements in Summer 2026Read More
Data Protection and Privacy
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Create Preference Form Access Tokens with REST API

            You are here:

            1. Salesforce Help
            2. Docs
            3. Data Protection and Privacy

            Create Preference Form Access Tokens with REST API

            Create an access token for Preference Manager forms by using REST API.

            Required Editions

            After you generate the access token, append the access token string ?pctoken=[token string] to the website URL of your published site. Then send this URL to your users to give them access to the preference form without logging in.

            Available in: Developer, Enterprise, Performance, and Unlimited Editions. Requires the Salesforce Privacy Center license.
            User Permissions Needed
            To use the Preference Manager Builder: ManagePreferenceManager

            Syntax

            URI services/data/vXX.X/consent/prefcenter/token
            Formats JSON
            HTTP Methods POST
            Authentication Bearer Token
            Request Parameters recordId
            Request Body

            The request body contains a JSON object with the record ID of the associated object. 

            {
  [recordId]            // String, Required
}
            Response Body

            The response body returns a JSON object containing the token for the user associated with the provided recordId.

            {
  "success":                     // Boolean
  "tokenMapping": {              // Object
  "token": "xxxxxxxxxxxxxxxx"    // String
                  },
  "tokenErrors": {},             // Object 
  "error": ""                    // String 
}
            • success returns a true or false statement to indicate if the request was successful.
            • tokenErrors indicates if there was an error revoking the token. If you included multiple tokens, the response indicates any errors for each individual token.
            • error indicates if there was a system error while processing the request.

            Example Response Body

            This example shows a successful response for a request with the record ID 0034L00000CZqeqQAD.

            
{
  "success" : true,
  "tokenMapping" : 
    {
    "token": "QTRMMDAwMDAwNTRQSGc0ZlhSczZnSXNTNEpNUVBldWN6
              cFl0bDRNcERURWRMWGJPZ1hhamxQTnUxa2oxN0dXVVFM
              alhwNFY1NXVxaDlrcXEwcFhuQy94WGNBYmMyMkZaWjJR
              L1VTOWw0UVhiZ2s4dFZaMUM0M053M01wWllUUTQzODZ1
              VjFLekxod2xQZ2NNQzRIYzNuM2RtRW9kVTRTN1lEdz09"
    },
  "tokenErrors": {},
  "error": ""
}
             
            Loading
            Salesforce Help | Article