Secure Payloads for production
Before Payloads runs in production, review access the same way you would review any integration surface in Salesforce.
Payloads can send data out of Salesforce, receive data from other systems, write Salesforce records, and store authentication configuration. That is exactly why the security model should be deliberate rather than inherited from whichever user happened to build the first Payload.
This checklist focuses on the practical checks that prevent most production issues.
Assign the right users
Only users who build or support integrations should have Payloads admin access.
Assign Payloads Admin to builders, admins, and support users who need to create or troubleshoot Integrations, Payloads, Credentials, Endpoints, Transformations, Jobs, and Batch Engine settings.
Do not assign builder access to every business user who benefits from the integration. Most business users should interact with the Salesforce process that triggers Payloads, not with Payloads configuration itself.
Use the packaged permission set as the starting point, then grant business object access separately.
For the detailed permission article, see Set up permissions and access.
Separate configuration access from data access
Payloads configuration access lets a user define integration behaviour.
Business data access controls which Salesforce records and fields the user or guest user can read or write. Keep those two decisions separate.
For outbound Payloads, review the objects and fields used by Data Queries. For inbound Payloads that write Salesforce data, review the objects and fields used by Data Targets. The integration should only read and write what the business process requires.
If a Payload fails because a field is not accessible, fix the specific object or field access. Do not grant broad access to make the error disappear.
Review Credentials
Credential records control how Payloads authenticates with external systems.
Before production use, check:
the Credential type matches the external API
API keys and tokens are test-safe in sandboxes and production-safe in production
certificates use the correct Salesforce certificate unique name
users do not paste real secrets into screenshots, tickets, or article drafts
exported
.payloadsfiles are treated as sensitive if they include Credentials
Credential values should be handled as integration secrets, even when the surrounding Payload configuration is safe to share.
For credential setup, start with Credentials Overview.
Harden inbound Endpoints
Inbound Endpoints are public-facing when they are exposed through Salesforce Sites.
Before sharing an Endpoint URL externally, check:
the Salesforce Site is intended for API traffic
the Endpoint uses the expected HTTP method
Echo Mode is turned off outside testing
required headers or parameters are documented for the calling system
the Site Guest User has only the package and business data access it needs
the Payload models only the inbound values Payloads needs to process
Inbound security is a combination of Endpoint configuration, Site configuration, and guest user permissions.
For setup details, see Set up inbound endpoints and Sites and Configure Endpoints.
Check Data Targets before enabling inbound writes
Inbound Payloads that write to Salesforce should be reviewed carefully.
Check each Data Target:
the target object is the intended object
the operation is correct
matching fields or identifiers are deliberate
multi-record targets are backed by the correct source array
all-or-none behaviour matches the business risk
daisy-chained target fields are intentional
For target behaviour, see Configure Data Targets and Map Data Target fields.
Review Jobs and retention
Jobs are useful for support, but they can contain request bodies, response bodies, headers, parameters, and target data.
Set retention rules that keep enough history for troubleshooting without storing integration data longer than needed. Failed Jobs often need a longer retention window than completed Jobs because they support investigation.
For retention setup, see Configure Job retention and cleanup.
Confirm subscription health
Open Billing before go-live and after each package upgrade.
Payloads needs a verified subscription state before runtime execution. If the subscription service stops or fails for any reason, Payloads will cease to operate after 7 days.
For subscription details, see Manage subscription and billing.
Final production checklist
Before go-live, confirm:
Payloads Admin is assigned only to the right users
Site Guest User permissions are narrow and reviewed
Credentials contain production-approved values
Endpoints use the correct Site, method, and URL
Echo Mode is disabled on live Endpoints
Data Queries only read required data
Data Targets only write required data
Job retention settings are configured
Billing shows the org is verified
at least one realistic test Job has been reviewed end to end



