This article covers the permissions and visibility requirements needed for the Turtl integration with Pardot (Account Engagement) and Salesforce.
The integration does not require any Salesforce-specific page layout changes, but the connected user will need the correct permissions in both platforms as detailed below.
What the integration does
Passes lead capture form data collected in Turtl Docs back to Pardot
Supports bulk creation of personalised Turtl Docs when sending bulk emails via Account Engagement
Surfaces Turtl engagement data within your CRM
Salesforce requirements
For a general overview of how permissions work in Salesforce, see Permissions and Access Settings in the Salesforce Help Centre.
User-level permissions
The Salesforce user connected to the integration must have:
API Enabled - required for API access
Customize Application OR Modify All Data - needed to automatically create and manage the custom Turtl_Personalized_Doc__c object and its fields via the Metadata API
Object & field-level security
For more detail on how field-level security works in Salesforce, see Field Permissions in the Salesforce Security Guide.
Lead object
Read access - to retrieve lead details
Edit access - to update the lookup to personalised Turtl documents
Fields requiring read access:
Id - lead identifier
Name - lead name
Email - lead email address
Turtl_SFID__c - custom Turtl ID field (if it exists)
Fields requiring edit access:
Turtl_Personalized_Doc__c - lookup field for personalised documents
Turtl_Personalized_Doc__c custom object
This custom object and all its fields are created automatically by the integration — no manual setup is required. The connected user will need full CRUD permissions (Create, Read, Edit, Delete) on this object.
Fields requiring read/edit access:
Name
lead__c
doc_id__c
doc_url__c
doc_title__c
pid__c
personalized_cover_image_url__c
personalized_cover_teaser_url__c
personalized_twitter_image__c
personalized_facebook_image_url__c
personalization_tag__c
Note: While no page layout changes are required, it is strongly recommended to make the relevant fields on both the Lead object and the Turtl_Personalized_Doc__c object visible on the page layouts used by your team.
Pardot (Account Engagement) requirements
Pardot uses role-based access control rather than field-level security. The connected user will need:
Pardot API User - the Salesforce user must have the Pardot API User checkbox enabled
Appropriate Pardot role - Marketing, Sales, or Admin role assigned based on the user's function
Business Unit assignment - the user must be assigned to the correct Pardot Business Unit
Once API access is granted, the integration automatically reads the following standard Prospect and Visitor fields:
id
email
first_name
last_name
crm_lead_fid
crm_contact_fid
salesforce_fid
lists