Skip to main content

Perform an API call in Zoho CRM

Performs an API call in Zoho

Application

  • Zoho

Inputs (what you have)

NameDescriptionData TypeRequired?Example
EndpointThe URL of the API endpoint to accessText (Long)Yeshttps://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 request. ​Note: If a file is added, leave request headers blank and add a 'filename' in your request body.FileNoexample.png
AutopaginateTrue/FalseNoWhether to automatically retrieve and combine paginated results
Max resultsIntegerNoThe maximum number of results to retrieve
Results JSONPathText(Short)NoThe path to the results in the response body

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)

NameData TypeDescriptionRequired?Example
Response status codeIntegerThe HTTP status code returned in the responseYes200
Response headersText (Long)Additional information provided in the response headersNoContent-Type: application/json
Response bodyText (Long)The main content of the responseNo{"message": "Success"}
Downloaded fileFileA file that is downloaded as part of the responseNoexample.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.

Outcomes

NameDescription
SuccessThis status is selected in the event that the API call returns with a status between 200-399
UnsuccessfulThis status is selected in the event 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