Job submissions

POST /submissions Session or API key

Submit a vacancy for review.

Body

url string required
Link to the original posting.Example https://acme.com/careers/123
title string required
Job title.Example Senior Go Engineer
company string required
Company name.Example Acme
location string
Free-text location.Example Remote — EU
remote boolean
Whether the role is remote.Example true
description string
Job description.
source string
Origin hint (optional).
posted_at string (RFC3339)
Original posting date (optional).
curl
curl -X POST "https://freehire.dev/api/v1/submissions" \
  -H "Authorization: Bearer $FREEHIRE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://acme.com/careers/123","title":"Senior Go Engineer","company":"Acme","remote":true}'
json — response
{ "data": { "id": 9, "status": "pending", "title": "Senior Go Engineer", "company": "Acme", "url": "https://acme.com/careers/123" } }