Skip to main content

Understand Job records

Understand what a Job record shows after Payloads runs, including status, request data, response data, target output, replay, and metrics.

Understand Job records

A Job record is the audit trail for one Payload run.

The Payload record shows what should happen. The Job shows what actually happened: the runtime inputs, generated request, response, Salesforce writes, errors, and performance metrics for that run.

If you are testing a Payload from the UI, start with Run a Payload manually.

Use the Jobs tab to find the right run

Open the Jobs tab when you need to find recent runs across the app.

You can filter by Integration, Payload, and Status. This is usually faster than opening an Integration or Payload first when you are responding to a support question.

The Jobs tab showing recent Payload runs with Integration, Payload, Status, Duration, and Created Date columns.

The Jobs tab is the fastest way to find a run when you only know the Integration, Payload, or status.

Read the Job header first

The Job header gives you the run context.

Check these fields first:

  • Payload: the Payload that ran.

  • Status: New, Completed, or Failed.

  • Firing Mode: Immediate, Queueable, or Batchable.

  • Endpoint: the URL or route used by the run.

  • Response Status Code and Response Status: the HTTP-style result Payloads recorded.

  • Error Message: the failure message, when the Job failed.

  • Created Date and Last Modified Date: when the Job was created and last updated.

A completed Stripe checkout Job showing Payload, status, firing mode, endpoint, response status, and timestamps.

Start with the header before checking lower-level request or response data.

Understand Job status

New means the Job has been created but has not completed yet. This is common for Batch Engine work waiting to be processed.

Completed means Payloads finished the run and considered it successful.

Failed means Payloads recorded an error, a failed response policy result, or a Salesforce write failure.

Status tells you the broad outcome, but it does not explain the cause by itself. Use the request, response, target output, and error message to understand what changed.

Check outbound data

Outbound data is what Payloads sent or prepared to send.

Depending on the Payload type, the outbound section can show:

  • Dynamic Inputs

  • Data Queries

  • Body

  • Headers

  • Parameters

  • Modifiers

Use this section when a value sent to an external API is missing, malformed, or different from the Payload configuration.

A Stripe checkout Job showing the outbound body generated at runtime.

The outbound body on the Job is the request Payloads actually generated for that run.

For mapping-specific troubleshooting, see Troubleshoot Payload mappings with Job data.

Check inbound data

Inbound data is what Payloads received or processed.

For an Outbound Payload, this is the external API response. For an Inbound Payload that writes Salesforce data, this is the inbound request. For an Email Handler Payload, this is the email content.

Depending on the Payload type, the inbound section can show:

  • Body

  • Headers

  • Parameters

  • Data Targets

Data Targets are especially useful because they show the records Payloads attempted to create, update, or upsert.

A Stripe event Job showing Data Target results and the field values Payloads attempted to write.

Target output shows the Salesforce write result for each configured Data Target.

Use Metrics when performance matters

Select Metrics when you need to understand runtime cost.

Metrics show total runtime, callout duration, query duration, DML duration, CPU time, query count, DML rows, and heap usage. Use them when a Payload is slow, close to limits, or doing more work than expected.

A Job Metrics modal showing runtime, CPU, Data Query, DML, and heap usage.

Metrics help separate API latency, Salesforce query cost, DML cost, and Apex limit pressure.

Replay a Job

Use Replay Job when you want to repeat a run after changing configuration.

For most Payload types, Replay opens the runner modal with values from the Job already populated. For Email Handler Jobs, Replay reprocesses the captured email content.

Replay is useful for controlled testing, but treat it as a new run. Always review the new Job rather than assuming it matched the previous one.

What to check before escalating

Before asking a developer or admin to investigate, collect:

  • the Job name or link

  • the Payload name

  • the status and error message

  • the response status code and response status

  • the outbound body, headers, parameters, or modifiers if the external API rejected the request

  • the inbound body and target output if Salesforce data was not written correctly

  • the Metrics view if the issue is performance or limits

If the Job failed, use Troubleshoot failed Jobs.

Did this answer your question?