JSON API Integration

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Push a Job (Create)

{
  "title": "Software Engineer",
  "reference_number": "JOB-001",
  "url": "https://yoursite.com/job/001",
  "company": "Acme Corp",
  "description": "<p>Full description with HTML</p>",
  "job_board": "Monster",
  "board_username": "your_username",
  "board_password": "your_password",
  "city": "New York",
  "state": "NY",
  "country": "US",
  "postal_code": "10001",
  "address": "123 Main Street",
  "salary": "$80,000 - $120,000",
  "job_type": "Full-Time",
  "category": "Engineering",
  "notification_email": "hr@acme.com",
  "expiry_date": "2026-06-30T00:00:00Z"
}

Remove a Job

{
  "action": "remove",
  "reference_number": "JOB-001"
}

Core Required Fields

• title, reference_number, url, company, description
• job_board, board_username, board_password
• city, state, country, postal_code
• job_type, category, notification_email, expiry_date

Optional Fields

• publication_date — defaults to current time
• address — required for OFCCP clients
• salary, priority, branch, owner_id
• statewide, nationwide — boolean flags
• indeed_sponsor_value — dollar amount for Indeed job sponsorship (e.g. "$50.00")

Response Codes

• 201 Created — job pushed
• 200 OK — job removed
• 400 Bad Request — validation failed
• 401 Unauthorized — missing/invalid API key
• 403 Forbidden — inactive account
• 404 Not Found — reference not found for remove
• 409 Conflict — duplicate reference number
• 500 Server Error — retry/contact support

Related Documentation

• XML Feed Integration
• File Upload Integration
• Pricing