Request Body Unique identifier for the company
Title of the job position
Department where the job belongs. Allowed departments: Accounting/Auditing Administrative Advertising Analyst Art/Creative Business Development Consulting Customer Service Design Distribution Education Engineering Finance Health Care Provider Human Resources Information Technology Legal Management Manufacturing Marketing Product Management Project Management Production Public Relations Purchasing Quality Assurance Research Sales Science Strategy/Planning Supply Chain Training Operations Other
Country where the job is located
City where the job is located
Salary information for the position
Currency of the salary. Valid currency is in three-letter alphabetic codes. Examples: USD EUR GBP
Period of the salary. Options: Per hour Per day Per week Bi-weekly Per month Per year
Hide salary in job application. Default is false
Employment type. Options: Full-time Part-time Contract Freelance Internship Temporary Project-based
Workplace type. Options: On-site Remote Hybrid
Career Level. Options: Junior Mid-level Senior Team Leader Manager Director VP C-level
Full description of the job requirements and responsibilities
Array of job posting sources. Options: LinkedIn Referral Alien Talents Facebook WhatsApp Pinterest Reddit Snapchat TikTok X Instagram Xing WeChat YouTube Indeed My Website Other Hirempire
Job posting status. Options: Pending Active Paused Hired Closed Delete. Default is Pending
Authentication Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
cURL
JavaScript
Python
PHP
Ruby
Go
Java
C#
Swift
Kotlin
Rust
curl --location --request POST 'https://api.hirempire.com/v1/add-job' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "company_id": "12345", "job_title": "Software Engineer", "department": "Engineering", "job_country": "USA", "city": "San Francisco", "salary": 100000, "currency": "USD", "salary_period": "Per year", "hide_salary": false, "job_type": "Full-time", "workplace": "Remote", "career_level": "Mid-level", "job_description": "Develop and maintain software applications, collaborate with cross-functional teams, and ensure high-quality code through testing and code reviews.", "job_sources": ["LinkedIn", "Facebook"], "status": "Active" }'
Response Indicates if the job was created successfully
Unique identifier for the newly created job
Current status of the job posting
Number of applications received for this job
Array of application objects Show Application Object Properties
Unique identifier for the application
ISO 8601 timestamp when the application was created
Source platform where the application came from
URL to view the full application details
{ "success" : true , "job_id" : "xyz456abc123" , "job_status" : "Active" , "total_applications" : 2 , "applications" : [ { "id" : "xyz456abc123" , "created_at" : "2025-02-25T03:23:32.000Z" , "source" : "Facebook" , "application_url" : "https://www.hirempire.com/job-application?recordid=xyz456abc123" }, { "id" : "xyz456abc123" , "created_at" : "2025-02-25T03:23:32.000Z" , "source" : "LinkedIn" , "application_url" : "https://www.hirempire.com/job-application?recordid=xyz456abc123" } ] } Error Responses Authorization Errors 400 - Bad Request { "success" : false , "error" : "Missing 'Authorization' header." } 400 - Bad Request { "success" : false , "error" : "Authorization header must start with 'Bearer '." } 400 - Bad Request { "success" : false , "error" : "Query parameters or URL params are not allowed." } Missing Required Fields 400 - Bad Request { "success" : false , "error" : "Missing required field: company_id" } 400 - Bad Request { "success" : false , "error" : "Missing required field: job_title" } 400 - Bad Request { "success" : false , "error" : "Missing required field: department" } 400 - Bad Request { "success" : false , "error" : "Missing required field: job_country" } 400 - Bad Request { "success" : false , "error" : "Missing required field: salary" } 400 - Bad Request { "success" : false , "error" : "Missing required field: currency" } 400 - Bad Request { "success" : false , "error" : "Missing required field: salary_period" } 400 - Bad Request { "success" : false , "error" : "Missing required field: job_type" } 400 - Bad Request { "success" : false , "error" : "Missing required field: workplace" } 400 - Bad Request { "success" : false , "error" : "Missing required field: career_level" } 400 - Bad Request { "success" : false , "error" : "Missing required field: job_description" } 400 - Bad Request { "success" : false , "error" : "Missing required field: job_sources" } Field Validation Errors 400 - Bad Request { "success" : false , "error" : "Field 'salary' must be a number." } 400 - Bad Request { "success" : false , "error" : "Invalid salary_period. Allowed values: Per hour, Per day, Per week, Bi-weekly, Per month, Per year" } 400 - Bad Request { "success" : false , "error" : "Invalid job_type. Allowed values: Full-time, Part-time, Contract, Freelance, Internship, Temporary, Project-based" } 400 - Bad Request { "success" : false , "error" : "Invalid workplace. Allowed values: On-site, Remote, Hybrid" } 400 - Bad Request { "success" : false , "error" : "Invalid career_level. Allowed values: Junior, Mid-level, Senior, Team Leader, Manager, Director, VP, C-level" } 400 - Bad Request { "success" : false , "error" : "Field 'job_sources' must be an array." } 400 - Bad Request { "success" : false , "error" : "Invalid job_source: [source_name]. Allowed: LinkedIn, Referral, Alien Talents, Facebook, WhatsApp, Pinterest, Reddit, Snapchat, TikTok, X, Instagram, Xing, WeChat, YouTube, Indeed, My Website, Other, Hirempire" } 400 - Bad Request { "success" : false , "error" : "Field 'status' must be a string if provided." } Company Authorization Errors 401 - Unauthorized { "success" : false , "error" : "Invalid company id" } 401 - Unauthorized { "success" : false , "error" : "Unauthorized. You don't have the permission post a job in this company." } Limit Reached Error 402 - Payment Required { "success" : false , "error" : "Active jobs limit reached. Upgrade to add more, or close one of your jobs." } Token Validation Errors 400 - Bad Request { "success" : false , "error" : "Invalid token" } 401 - Unauthorized { "success" : false , "error" : "Token is expired" } 403 - Forbidden { "success" : false , "error" : "Token has been deleted" } 401 - Unauthorized { "success" : false , "error" : "Token is missing required scope 'Jobs'" }
