Skip to main content
Sign in

Using HTTP Raw - Interpreting HubSpot Post Out Responses & Common Errors

danny.latour
  • Updated

Relevant to: Demand Acceleration Platform

This article relates to the use of HTTP Raw to set up an integration with HubSpot.
If you are unsure which integration method to use, see HubSpot Post Out Methods.

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 HubSpot Response, which is received by the Demand Acceleration Platform whenever a lead post out is attempted.

The HubSpot Response can be found in both the testing modal (when testing your integration) and as a column in a post out log report (generated once the Source/Campaign has started to collect data).

 

 

Understanding the HubSpot 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 HubSpot.
  • The response - the information that HubSpot sent back to the Demand Acceleration Platform.

 

The request

In the Test Integration modal (displaying Sandbox Test Results) - see the Request section.

dap-postouts-interpretinghubspot-03.png

 

In a Post Out Log Report  - see the RequestContent column.

To read the request code:

  • This displays the HubSpot field name and corresponding value that was sent into it.
  • Review this section in detail to confirm all the fields have attributed values and that any list value mappers are working properly.

Example: field and value highlighted in bold.

{
"properties": [
{
  "property" : "firstname",
  "value" : "John"
},
{
  "property" : "lastname",
  "value" : "Smith"
},
{
  "property" : "xxx",
  "value" : "xxx"
},
{
  "property" : "xxx",
  "value" : "xxx"
},
]
}

 

The response

The response code displays the exact response that was received from HubSpot. It will look different depending on whether or not the test lead has been successfully received and/or if a custom response has been set up. 

 

In the Test Integration modal (displaying Sandbox Test Results) - see the Response section.

dap-postouts-interpretinghubspot-04.png
In a post out log report - see the ResponseContent column.

A successful response

The response should:

  • Return a 200 response on success. The response will contain a vid of the updated or created record, and an isNew field that indicates if a new record was created. If the field is false, an existing record was updated.
  • Return a 409 Conflict error response if you are trying to update the email address of a record, and there is an existing record with the new email address.

Example: values indicating success are highlighted in green.

{
  "vid" : 200,
  "isNew" : true
},

Success! Now check that the lead has been received in HubSpot and confirm that it is properly routed and the data is complete.
If you don't have access to HubSpot, collaborate with your system admin to confirm that test lead(s) have been received in HubSpot.

 

A failed response / unsuccessful code

Unsuccessful responses typically contain the value error.

Example: values indicated a failed response are highlighted in red.

 {
"message": "Invalid input (details will vary based on the error)",
"correlationId": "abc1d234-5e67-8901-2345-678fg90h1ijk",
"category": "VALIDATION_ERROR",
}

 

 

Error responses seen most often in the Demand Acceleration Platform

The table below shows the error responses that are most commonly encountered in the Demand Acceleration Platform. If you have received one of the responses 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.
If not, follow the recommendation in the 'Suggested solution' column below.

Response Description Suggested solution 
[Field] ... This field 
is required.
 The test lead is missing a value in a required field. Add a value to the required field in the test lead form.

 

Speak with your Customer Success Manager if you need help understanding or correcting an error.

 

 

Recommended Reading

 

For more help, get in touch with our Support Team or your Customer Success Manager.

Related articles