QuickApply Integrations

Our QuickApply API enables seamless integration with various job boards, allowing candidate applications to be received from these platforms and forwarded directly to the end customer's ATS (Applicant Tracking System). This documentation outlines how the webhook URLs are structured and how XML job feeds must be adjusted by agencies or partners to include the webhook links, ensuring that the candidate application flow is correctly triggered.

🔗 Webhook Overview

Webhooks are essential for real-time data transfer between the job board and the customer's ATS. When a candidate applies through a job board using QuickApply, the application data is sent to a webhook endpoint provided by our system. This ensures that the application reaches the customer's ATS instantly and without manual intervention.

Each job board requires a unique webhook URL that must be included in the XML job feed submitted by the agency or partner. The webhook URL is specific to each job posting and is dynamically generated based on the job details.

📥 How Webhook URLs Are Generated

The webhook URL for every partner follows this pattern:

https://api.getkini.com/webhooks/{talent_channel}/{kini_partner_id}/{kini_company_id}/{external_job_id}

• talent_channel: the integration slug (indeed, monster, jobrapido, heyflow, meta, perspective).
• kini_partner_id: the partner ID provided by the Kini team.
• kini_company_id: the Kini company the application should be forwarded to.
• external_job_id: the job's ID in the connected ATS.

See each partner page for the exact URL, an example, and any talent channel-specific fields.

📝 How to Update XML Job Feeds

To ensure that candidate applications are correctly routed to the customer's ATS via our webhooks partners must update their XML job feeds to include the webhook URLs.

Here's how to adjust the XML feed:

Before Update (Standard XML Feed):

<job>
  <id>12345</id>
  <title>Software Engineer</title>
  <location>Berlin, Germany</location>
  <apply-url>https://jobs.example.com/apply/12345</apply-url>
</job>

After Update (With Webhook URL):

<job>
  <id>12345</id>
  <title>Software Engineer</title>
  <location>Berlin, Germany</location>
  <apply-url>https://api.getkini.com/webhooks/applications/indeed/12345/abc123</apply-url>
</job>

📌 Important Notes

• Ensure that the webhook URLs are correctly formatted in the XML feed to avoid broken application flows.
• Always test the updated XML feed before going live to ensure that the candidate application data is correctly routed to our webhook.
• Make sure to insert a valid external_job_id

By following these guidelines, agencies and partners can ensure a smooth and reliable integration with the QuickApply API, improving the overall candidate experience and automating the application process for the end customer.