Connecting a Custom Form

Several clients choose to host their hiring page on their primary website, and seamlessly forward applicants into the Fountain portal to increase conversion. To utilize this functionality, use our API endpoint Create an Applicant to make a POST request, and we'll respond with an applicant_id. Note that the code responsible for calling the API endpoint needs to reside server side so that your API token is not exposed through client-side code; failure to do so could lead to abuse of your API token and the creation of spam applicants.

POST Create an Applicant Request

curl -X POST -H 'Content-Type: application/json' -H 'X-ACCESS-TOKEN: secret-api-token' -d '{"name":"John","email":"[email protected]","phone_number":"5034834844","data":{"city":"San Francisco","transportation":"Bicycle"}}' ''

Once upon processing the POST request, you'll get a response containing your new applicant's Fountain data.


  "id": "e8e4edc5-096c-47ea-b682-f77c6c4462dd",
  "email": "[email protected]",
  "name": "John",
  "phone_number": "5034834844",
  "data": {
    "city": "San Francisco",
    "transportation": "Bicycle",
  "created_at": "2015-06-05T05:53:46.749-07:00",
  "funnel": {
    "id": "de79f80f-43da-4e4c-87d6-9bf714753535",
    "title": "San Francisco Bicycles"
  "stage": {
    "id": "4d09fca4-6599-4418-b385-6cf173e01b66",
    "title": "Phone Screen"
  "background_checks": [],
  "document_signatures": [],
  "labels": []

Append the response's applicant id to the end of your portal URL (, and redirect the applicant there. They'll automatically land in the first stage of the applicant portal. If you have set up several eligibility filters in Fountain, the applicant will receive the appropriate messaging based on their status in the workflow.


Note: UTM Tracking

To use UTM tracking for your form, simply pass the desired UTM fields (i.e. "utm_source"="craigslist") along with the rest of an applicant's data.