Developers

    Build on Hayes

    REST API, signed webhooks, and job syndication feeds. Connect your TMS, CRM, or build a custom workflow with Zapier in minutes.

    REST API

    Bearer-token authenticated JSON endpoints for jobs, applications, and candidates.

    https://bxsihfkpifqlteteredg.supabase.co/functions/v1/public-api

    Webhooks

    HMAC-signed event delivery. Subscribe to new applications, hires, interviews, and status changes.

    X-Hayes-Signature

    Job Feeds

    Indeed-compatible XML and Google for Jobs sitemap. All published postings, refreshed every 15 minutes.

    See feeds →

    Zapier

    Trigger zaps on new applications, send hires to Google Sheets, push to Slack. No code required.

    Zapier recipes →

    Authentication

    All API calls require a Bearer token. Mint keys in Settings → API & Webhooks. Keys are prefixed hay_live_… and shown once.

    curl https://bxsihfkpifqlteteredg.supabase.co/functions/v1/public-api/v1/me \ -H "Authorization: Bearer hay_live_xxxxxxxxxxxxxxxx"

    Endpoints

    GET
    /v1/me

    Returns the agency owning the API key.

    GET
    /v1/jobs

    List published job postings (limit up to 200).

    GET
    /v1/jobs/:id

    Fetch a single posting with full template details.

    POST
    /v1/applications

    Create an applicant. Requires full_name plus email or phone. Optional posting_id.

    GET
    /v1/webhooks

    List your webhook subscriptions.

    POST
    /v1/webhooks

    Create a webhook. Returns the signing secret once.

    DELETE
    /v1/webhooks/:id

    Remove a webhook subscription.

    Webhook events

    application.created — new applicant submitted.
    application.status_changed — applicant stage moved.
    candidate.hired — applicant marked hired.
    interview.scheduled — interview slot booked.
    job.published — posting goes live.

    Payloads are JSON. Verify with HMAC-SHA256 over {timestamp}.{body} using your subscription secret. Header: X-Hayes-Signature: t=…,v1=….

    Job syndication feeds

    Indeed XML
    https://bxsihfkpifqlteteredg.supabase.co/functions/v1/jobs-feed?format=indeed
    Google for Jobs sitemap
    https://bxsihfkpifqlteteredg.supabase.co/functions/v1/jobs-feed?format=google

    Append &agency=<slug> to scope to a single agency.

    Errors

    401 Missing or invalid API key.
    400 Validation error — body explains what.
    404 Resource not found or not in your agency.
    500 Internal — report to support@hayesrecruitinghub.com.