Relevant to: Demand Acceleration Platform
Routine monitoring to check for errors is highly recommended to ensure leads are successfully posted to integrated systems. This can be done by reviewing the Salesforce Response, which is received by the Demand Acceleration Platform whenever a lead post out is attempted.
The Salesforce Response can be found in both the testing modal (when setting up your integration) and as a column in a post out log report (generated once the Source/Campaign has started to collect data).
In this article
Understanding the Salesforce Response
Whenever you send a test lead or routinely monitor post out lead flow, you are checking two things:
- The request - the data that was sent to Salesforce.
- The response - the information that Salesforce sent back to the Demand Acceleration Platform.
The request
The request displays the exact data that was sent to Salesforce.
In the Test Integration modal (displaying Sandbox Test Results) - see the Request section.
In a Post Out Log Report - see the RequestContent column.
To read the request code:
- The request section displays each field name and corresponding value that was sent into it.
- The values follow this pattern:
"yourSalesforceFieldName": "Your sample lead data",
- Review this section in detail to confirm all the fields have attributed values and that any list value mappers are working properly.
- The values follow this pattern:
Example: request code. { "FirstName": "Jane", "LastName": "Doe", "Company": "Company, Inc." } |
The response
The response code displays the exact response that was received from Salesforce. It will look different depending on whether the test lead has been successfully received or not.
In the Test Integration modal (displaying Sandbox Test Results) - see the Response section.
In a Post Out Log Report - see the ResponseStatusCode and ResponseReason columns.
A successful response
The main elements of a successful response are:
- An ID has been generated
- Indicates that the lead was created and/or located within Salesforce.
- Displayed in the response as:
"id":"1a2b3c",
- Success is 'true'
- Displayed in the response as:
"success":true,
- Displayed in the response as:
Example: values indicating success are highlighted in green. { "id": "00A1b2345678Cd9EFG", "success": true, "errors": [], "created": true } |
A failed response / unsuccessful code
Although the data may have been sent successfully, there may be an issue with it being received by Salesforce.
- There is a message that describes the issue
- Indicates a failure and will need action to correct before sending a new test. See more in the list of Salesforce error codes.
- Displayed in the response as:
"message": "aShortMessage"
- There is an error code that describes the issue
- This should help you understand why the lead has been unsuccessfully received by Salesforce. See more in Error codes seen most often in the Demand Acceleration Platform.
- Displayed in the response as:
"errorCode": "aDescription"
Example: values indicated a failed response are highlighted in red.
[ { "message": "Required fields are missing: [Company]", "errorCode": "REQUIRED_FIELD_MISSING", "fields": [ "Company" ] } ]
|
Error codes seen most often in the Demand Acceleration Platform
The table below shows the error codes that are most commonly encountered in a Post Out Log Report. If you have received one of the codes noted here, follow the action as described in the solution column.
If the Source is live and you are reviewing this in a Post Out Log Report, first check all instances of the Lead ID to see if a successful post out has been subsequently recorded. |
Response Code (from Salesforce) |
Description (from Salesforce) |
Suggested solution |
415 | The entity in the request is in a format that’s not supported by the specified method. |
|
401 | The session ID or OAuth token used has expired or is invalid. The response body contains the message and errorCode. |
|
503 | The server is unavailable to handle the request. Typically this occurs if the server is down for maintenance or is currently overloaded. |
|
Other response codes can be found in the list of Salesforce error codes. Speak with your Customer Success Manager if you need help correcting the error.
Recommended Reading