Authentication Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
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. Example: LinkedIn Referral or any source you would like to add.
Industry classification (optional).
URL slug for the public job board page. If omitted, auto-generated from the job title with a random 4-char suffix.
Application form configuration (optional). Object shape: { "fields": { "show_cover_letter": boolean, "show_photo": boolean, "show_experience_years": boolean, "show_languages": boolean, "show_nationality": boolean, "show_location": boolean, "show_salary_expectation": boolean }, "custom": [ { "label": string, "type": string, "options": any, "required": boolean } ] }
custom[].type must be one of: text textarea number date url file single_select multi_select video audio.Job posting status. Accepted input values: Pending Active Paused Hired Closed. Values are normalized to lowercase before storage. Pending is mapped to draft. Hired is accepted as a deprecated alias for Closed. Default is draft.
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 (lowercase). One of: draft active paused closed
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" : "f3a2c1d4-1111-4222-9333-444455556666" , "job_status" : "active" , "total_applications" : 0 , "applications" : [] }
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 401 - Unauthorized { "success" : false , "error" : "Invalid token" }
401 - Unauthorized { "success" : false , "error" : "Token is expired" }
