Integrate Knowledge Base

If you wish to be informed what the status (accepted, rejected) of a posted lead was, you will need to provide a callback URL in your initial post of a lead to Integrate. Integrate will then post a status to the provided URL when a lead has completed processing through the platform.


The callback should be provided in the POST URL. The address provided by the pub should accept a JSON POST request. Included below is the example of the format for the request. This address is called anytime the status of a lead they posted in changes. That means it can be called multiple times over the life of the lead. The statuses are expected to expand. I’ve only included the current set.


POST http://prod.api.integrate.com/post/ffe56027-150f-493f-b554- 31952553fbfa?callback=[address here] HTTP/1.1


The body of the message we send is of mime type `application/json` and looks like the following.


POST [callback address provided] HTTP/1.1 Content-Type: application/json

{

“id”: <ORIGINAL GUID OF LEAD>,

“status”:  <ONE OF  STRING>”accepted”, “rejected”, “failed”,

“reason”: <ADDITIONAL INFORMATION RELATED TO THE STATUS STRING> “timestamp”: <ISO 8601 UTC DATE STRING>

}

Full  Request Example:

POST http://somewhere.com/my/lead/status HTTP/1.1 Content-Type: application/json

{

“id”: “6953f82c-292e-47a6-989e-2de5b7d4e9a7” “status”: “rejected”,

“reason”: “Address validation failed” “timestamp”: “2017-01-16T23:55:32+00:00”

}


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.