Skip to main content

Secure Payloads for production

Review the practical security checks admins should complete before running Payloads in production.

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.

The Payloads Admin permission set showing object and field access for Payloads records.

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 .payloads files are treated as sensitive if they include Credentials

An API Key Credential record for Stripe showing an Authorization header and generated header output.

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

The Endpoint modal showing a Salesforce Site, generated public URL, selected method, Echo Mode, and endpoint secret settings.

Inbound security is a combination of Endpoint configuration, Site configuration, and guest user permissions.

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

Did this answer your question?