Fountain Hire integrates with custom elements of your workflow through a combination of webhooks and PUT requests. Webhooks are used when external action is needed when an applicant arrives at a particular stage.
Example: When the applicants reach a particular stage, fire a webhook which will send them a text to download an app. When they do, update a label in Fountain Hire.
1. Fire a webhook trigger
When an applicant lands in a particular stage (Rejected in this example), a trigger fires to a third-party webhook URL with all of the applicant's details. In this example, we want phone number and type so we can send them a text with a link to the app. The payload is delivered as JSON object which includes the applicant's UUID, which will be used to target them when it's time to move pass the applicant along.
2. Third-party sends applicant a text
With the applicant's phone number, the third-party provider sends the applicant a text message to download the app based on the phone type.
3. Complete the label with a PUT request
When the applicant downloads and signs into the app with their Fountain email address, the third-party provider sends a PUT request to Fountain to update the 'App Downloaded' label. If the 'Auto-Advance when all labels are checked' setting is on in in your manual stage (you can toggle this in the Workflow Editor), the applicant automatically moves on to the next stage.
curl -X PUT -H 'Content-Type: application/json' -H 'X-ACCESS-TOKEN: secret-api-token' -d '{"completed":true}' 'https://api.fountain.com/v2/applicants/22222222-0000-0000-0000-000000000000/labels/App%20Downloaded'
5. Want add applicant data?
If you wish to append data to the applicant, just do so with another PUT request before auto-advancing the applicant. That's it!
Example: Using our API and a filter in your workflow, you can reject applicants from third-party sources. For this example, you'll need applicants in a stage before the Rejected stage. In this example let's call this Manual stage.
1. Set up your label
First, set up a label which signifies the completion of your Manual stage. Make sure the 'Auto-Advance when all labels are checked' setting is on.
2. Make a filter
You'll need to create a filter based on some field that you'll set for the applicant via PUT. Here, we simply call it "reject" - if an applicant passes into the filter with reject = "not experienced", they'll be rejected with that reason.
3. Set your filter field with a PUT request
Next you'll set whatever field your filter uses for a particular applicant in the Manual stage (use List Applicants to get applicant_id's).
curl -X PUT -H 'Content-Type: application/json' -H 'X-ACCESS-TOKEN: secret-api-token' -d '{"data":{"reject":"not experienced"}}' ' https://api.fountain.com/v2/applicants/c6786558-1b20-4e44-b303-75e21b965ed7/'
4. Complete the label with a PUT request
Finally, set the label you made to completed. The applicant will move into the filter, then they'll be pushed into Rejected stage.
curl -X PUT -H 'Content-Type: application/json' -H 'X-ACCESS-TOKEN: secret-api-token' -d '{"completed":true"}' 'https://api.fountain.com/v2/applicants/22222222-0000-0000-0000-000000000000/labels/reviewed'