// This module is included in the following assemblies:
// as_triggering-integrations-with-http-requests.adoc

[id='guidelines-for-service-sending-requests_{context}']
= Guidelines for an HTTP client that invokes a {prodname} Webhook

When you implement a client that sends an HTTP request to {prodname}, 
your implementation should:

* Add to the {prodname}-provided external URL to construct a URL that makes a 
`GET` or `POST` request.
* In the URL request, specify HTTP header and query parameter values 
whose data types adhere to the `io:syndesis:webhook` JSON schema. See
link:{LinkSyndesisIntegrationGuide}#about-json-schema-for-http-requests_webhook[About the JSON schema for specifying request parameters]. 
When header and query parameters 
adhere to this data type specification, then you can map parameter fields to 
fields that the next connection in the integration can process. 
* If the request succeeds, handle a returned success code of `201`. 
* If the request fails, handle an HTTP `5xx` error code.
* Not expect any other response from {prodname}. In other words, 
sending the request does not directly return data to the requesting
client other than the return code. 
