Happydance Integration

Table of Contents

API Key Management

Get a single job from ATS linked account

Get all jobs from ATS linked account

API Key Management

• Only admins have the ability to generate/create the API key. This can be done from the organizational settings page in Findem. 
• Currently there is a limit of 1 token/API key per account. (based on the allowlisting accounts on Findem production).

Endpoint:

• URL: “/hm/api/public_api_token”
• Method: [GET, POST, DELETE]
• Description: Use this api to create or delete the API key. 

Get a single job from ATS linked account

• Use this API to get a job posting from the Findem DB

Endpoint

• URL: “/jobs/{job_id}”
• Method: [GET]
• Description: Use this API to fetch a single job posting (specific) from the ATS linked account.
• Parameters: 
  • Parameter 1: job_id (ID of a Job)
  • Parameter 2: API_KEY
• Example Request: 

curl -k --location 'https://api.findem.ai/pub_api/v1/ats/jobs/4989941003' \

--header 'Authorization: Api-Key API_KEY'

• Example Response:

{

"status": "success",

"jobs": [{

  "ats_job_id": "ocuhufwb",

  "job_created_ts": 1722977484448,

  "postingType": "Limited Access",

  "job_last_updated_ts": 1722981531640,

  "job_location": {

    "country": "United States",

    "city": "Phoenix",

    "state": "Arizona"

  },

  "job_name": "Systems Sales Engineer (Pre-Sales)",

  "job_state": "open",

  "last_sync_ts": 1722985529139,

  "posting_details": {

    "external_job_url": null,

"job_description": "

Hungry, Humble, Honest, with Heart.

The Opportunity

Do you love discovering customers' business challenges and crafting unique solutions for them? Are you ready for an opportunity to transform the way companies work?

If hired, employee will be in an "at-will position" and the Company reserves the right to modify base salary (as well as any other discretionary payment or compensation program) at any time, including for reasons related to individual performance, Company or individual department/team performance, and market factors. Our application deadline is 40 days from the date of posting. In good faith, the posting may be removed prior to this date if the position is filled or extended in good faith.

",

"additional_information": ""

},

"requisition_id": "27283"

}]

}

Get all jobs from ATS linked account

• Use this API to get all jobs from the ATS linked Findem account.

Endpoint

• URL: "/jobs"
• Method: [GET]
• Description: Use this API to get list of all jobs
• Parameters:
  • Parameter 1: API_KEY
  • Query Parameters (optional): created_after={epoch_ts}
• Supported Filters:
  • The HappyDance API currently supports only two filters: job_id and created_after.
  • No additional filters are available for fields like region, country, or requisition ID.
  • Any further filtering must be handled on the client side after receiving the complete list of results.
• Example Request:

curl -k --location 'https://api.findem.ai/pub_api/v1/ats/jobs?created_after=1722973036814 \

--header 'Authorization: Api-Key KEY'

• Example Response:

{

"status": "success",

"jobs": [

{

"ats_job_id": "ocuhub",

"job_created_ts": 1722977484448,

"postingType": "Limited Access",

"job_last_updated_ts": 1722981531640,

"job_location": {

"country": "United States",

"city": "Phoenix",

"state": "Arizona"

},

"job_name": "Systems Sales Engineer (Pre-Sales)",

"job_state": "open",

"last_sync_ts": 1722985529139,

  "posting_details": {

    "external_job_url": null,

    "job_description": "

Hungry, Humble, Honest, with Heart.

The Opportunity

Do you love discovering customers’ business challenges and crafting unique solutions for them? Are you ready for an opportunity to transform the way companies work?

If hired, employee will be in an “at-will position” and the Company reserves the right to modify base salary (as well as any other discretionary payment or compensation program) at any time, including for reasons related to individual performance, Company or individual department/team performance, and market factors. Our application deadline is 40 days from the date of posting. In good faith, the posting may be removed prior to this date if the position is filled or extended in good faith.

",

    "additional_information": ""

  },

  "requisition_id": "2728443"

},

{

  "job_id": "oAshuf",

  "job_created_ts": 1722974036814,

  "postingType": "Limited Access",

  "job_last_updated_ts": 1722981531640,

  "job_location": {

    "country": "United States",

    "city": "Phoenix",

    "state": "Arizona"

  },

  "job_name": "Systems Sales Engineer (Pre-Sales)",

  "job_state": "open",

  "last_sync_ts": 1722985529139,

  "posting_details": {

    "external_job_url": null,

    "job_description": "

Hungry, Humble, Honest, with Heart.

The Opportunity

Do you love discovering customers’ business challenges and crafting unique solutions for them? Are you ready for an opportunity to transform the way companies work?

If hired, employee will be in an “at-will position” and the Company reserves the right to modify base salary (as well as any other discretionary payment or compensation program) at any time, including for reasons related to individual performance, Company or individual department/team performance, and market factors. Our application deadline is 40 days from the date of posting. In good faith, the posting may be removed prior to this date if the position is filled or extended in good faith.

",

    "additional_information": ""

  },

  "requisition_id": "2724483"

},

]

}