Triggering a Responder via the REST API
If you're looking to manually trigger a Responder from an external source via the API, then this is the article for you.
Getting Started
In order to search via the REST API, you'll need a REST API key with the correct permissions.
Head to the Admin tab > Tech Hub > REST API to get started:
1) Create yourself an Administrator Key
2) Ensure the Administrator Key has the Trigger responders permission
3) Activate your Administrator Key
Triggering the Responder
In order to trigger the Responder, you'll be making a JSON Post to the below URL:
https://helpcentre.leadbyte.com/restapi/v1.3/responders/trigger
With the following body:
{ "key": "[API KEY GOES HERE]", "leadId": 1234, "responderId": 4567 }
You'll find the lead ID next to each lead and the Responder ID on your responder page once you've set up the responder and set it as "Trigger > Manually using REST API".
EG -
Successful Response
{ "status": "Success", "message": "See push results", "warnings": [ ], "pushResults": [ { "responderId": "123", "pushId": "456", "queued": true, "status": "Queued", "leadId": 1234 } ] }
FAQs
Can I trigger multiple Responders at once?
Sure thing, replace the single Responder ID with the below -
"responders": [ 123, 124 ]
Can I trigger a specific Push on my Responder?
You can indeed, replace the Responder ID with "pushId", this ID can be found on your Responder settings -
Further information can be found on the REST API key settings page.
Comments