Skip to main content

Perform an API call in HubSpot

Performs an API call in HubSpot.

Application

  • HubSpot

Inputs (what you have)

NameDescriptionData TypeRequired?Example
EndpointThe URL of the API endpoint to accessURLYeshttps://api.example.com/users
MethodThe HTTP method to be used for the requestPredefined Choice ListYesGET
Request headersAdditional headers to include in the request in JSON formatText (Long)No{"Content-Type": "application/json"}
Request bodyThe data to be included in the request bodyText (Long)No{"name": "John", "age": 25}
FileA file to be included in the requestFileNoexample.png

Note: the value of inputs can either be a set value in the configuration of the Wrk Action within the Wrkflow, or a variable from the Data library section. These variables in the Data library section are the outputs of previous Wrk Actions in the Wrkflow.

Outputs (what you get)

NameDescriptionData TypeRequired?Example
Response status codeThe HTTP status code returned in the responseIntegerYes200
Response headersAdditional information provided in the response headersText (Long)NoContent-Type: application/json
Response bodyThe main content of the responseText (Long)No{"message": "Success"}
Downloaded fileA file that is downloaded as part of the responseFileNoexample.pdf

Note: The "Fields to Capture" input feature can be used to create new outputs for the Wrk Action with the value of the corresponding key name in the first-level JSON output of the Wrk Action.

Example: If the "Response Body" output is equal to {"message": "Success"} Then you are able to add a "Fields to capture" input with the name "message" that will add an output to the Wrk Action called "message" which will have the value "Success"

Outcomes

NameDescription
SuccessThis status is selected in the event of that the API call returns with a status between 200-399
UnsuccessfulThis status is selected in the event of that the API call returns with a status of 400+
Impossible to CompleteThis status is selected in the event of the following scenario:Couldn't resolve hostnameThe external system is not accessible

Requirements

  • N/A