Skip to main content
POST
/
api
/
v1
/
jobs
Create Job
curl --request POST \
  --url https://api.example.com/api/v1/jobs \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "department": "<string>",
  "location": {
    "type": "<string>",
    "city": "<string>",
    "state": "<string>",
    "country": "<string>"
  },
  "description": "<string>",
  "requirements": [
    {}
  ],
  "skills": [
    {}
  ],
  "experience_level": "<string>",
  "employment_type": "<string>",
  "salary": {
    "min": 123,
    "max": 123,
    "currency": "<string>",
    "period": "<string>"
  },
  "assessment_config": {
    "auto_generate": true,
    "question_count": 123,
    "time_limit": 123,
    "proctoring": true,
    "question_types": [
      {}
    ]
  },
  "publish": true
}
'
{
  "data": {
    "id": "<string>",
    "title": "<string>",
    "status": "<string>",
    "assessment_id": "<string>",
    "application_url": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "assessment_generation_time": 123
  }
}

​
Overview

Create a new job posting that automatically generates AI-powered assessments. Jobs created via API have the same features as those created in the dashboard.

​
Request

​
title
string
required
Job title (e.g., “Senior Software Engineer”)
​
department
string
Department name (e.g., “Engineering”, “Sales”, “Marketing”)
​
location
object
Job location details
​
description
string
required
Full job description (supports Markdown)
​
requirements
array
List of job requirements
​
skills
array
Required skills for the position
​
experience_level
string
Experience level: entry, mid, senior, lead, or executive
​
employment_type
string
Employment type: full_time, part_time, contract, or internship
​
salary
object
Salary information
​
assessment_config
object
Assessment configuration
​
publish
boolean
default:"false"
Publish immediately after creation

​
Response

​
data
object
The created job object
​
meta
object
Response metadata

​
Examples

curl -X POST https://api.hirepanda.com/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Software Engineer",
    "department": "Engineering",
    "location": {
      "type": "remote",
      "country": "US"
    },
    "description": "We are looking for a Senior Software Engineer...",
    "requirements": [
      "5+ years of experience",
      "Strong JavaScript skills",
      "React expertise"
    ],
    "skills": ["JavaScript", "React", "Node.js", "TypeScript"],
    "experience_level": "senior",
    "employment_type": "full_time",
    "salary": {
      "min": 120000,
      "max": 180000,
      "currency": "USD",
      "period": "yearly"
    },
    "assessment_config": {
      "auto_generate": true,
      "question_count": 10,
      "time_limit": 300,
      "question_types": ["ranksort", "multiple_choice"]
    },
    "publish": true
  }'

​
Response Example

{
  "data": {
    "id": "job_abc123",
    "title": "Senior Software Engineer",
    "department": "Engineering",
    "location": {
      "type": "remote",
      "country": "US"
    },
    "status": "active",
    "assessment_id": "asmt_xyz789",
    "application_url": "https://apply.hirepanda.com/abc123",
    "candidate_count": 0,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  },
  "meta": {
    "request_id": "req_def456",
    "assessment_generation_time": 4523
  }
}

​
Error Responses

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request parameters",
    "details": {
      "title": "Title is required",
      "description": "Description must be at least 100 characters"
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests",
    "retry_after": 3600
  }
}

​
Webhooks

After creating a job, you can receive webhooks for:
  • job.created - Job successfully created
  • assessment.generated - AI assessment ready
  • application.received - New candidate applied
  • assessment.completed - Candidate finished assessment
Configure webhooks →

​
Next Steps

List Jobs

Retrieve all your jobs

Update Job

Modify job details

Get Candidates

View job applicants

Job Analytics

Track job performance