Skip to main content
POST
/
v1
/
jobs
Create job
curl --request POST \
  --url https://api.stardex.ai/v1/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "company_name": "<string>",
  "company_domain": "<string>",
  "company_linkedin_url": "<string>",
  "pipeline_template_name": "<string>",
  "team_members": [
    {
      "team_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_member_email": "<string>",
      "role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "role_name": "<string>"
    }
  ],
  "job_description": "<string>",
  "location": "<string>",
  "primary_url": "<string>",
  "currency_code": "<string>",
  "job_function": "<string>",
  "open_date": "<string>",
  "end_date": "<string>",
  "salary_min": 1,
  "salary_max": 1,
  "fee": 1,
  "firm_commission_percent": 50
}
'
{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Senior Software Engineer",
    "created_at": "2024-01-10T09:00:00Z",
    "is_archived": false,
    "client_company_name": "StartupXYZ",
    "client_company_id": "456e7890-e12b-34d5-a678-901234567890",
    "client_company_domain": "startupxyz.com",
    "client_company_linkedin_url": "https://www.linkedin.com/company/startupxyz",
    "job_status_name": "Active",
    "job_status_id": "789e0123-e45f-67a8-b901-234567890123",
    "candidate_count": 12,
    "location": "San Francisco, CA",
    "primary_url": "https://startupxyz.com/careers/senior-swe",
    "job_function": "Engineering",
    "open_date": "2024-01-01",
    "end_date": null,
    "currency_code": "USD",
    "salary_range": "[150000,200000]",
    "description": "We are looking for a Senior Software Engineer to join our platform team...",
    "team_members": [
      {
        "team_member_id": "234e5678-e90a-12b3-c456-789012345678",
        "email": "jane@company.com",
        "first_name": "Jane",
        "last_name": "Smith",
        "role_id": "345e6789-e01b-23c4-d567-890123456789",
        "role_name": "Team Lead"
      },
      {
        "team_member_id": "345e6789-f01b-23c4-d567-890123456789",
        "email": "bob@company.com",
        "first_name": "Bob",
        "last_name": "Johnson",
        "role_id": "456e7890-f12b-34d5-e678-901234567890",
        "role_name": "Executive Sponsor"
      }
    ],
    "custom_fields": [
      {
        "attribute_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "attribute_name": "Priority",
        "data_type": "single-select",
        "value": null,
        "tag": {
          "id": "d4e5f6a7-b8c9-0123-defg-234567890123",
          "name": "High"
        },
        "team_member": null
      }
    ],
    "pipeline_stages": [
      {
        "id": "345e6789-e01b-23c4-d567-890123456789",
        "name": "Application Review",
        "stage_order": 1,
        "is_rejection_stage": false,
        "is_interviewing_stage": false
      },
      {
        "id": "456e7890-f12b-34d5-e678-901234567890",
        "name": "Phone Screen",
        "stage_order": 2,
        "is_rejection_stage": false,
        "is_interviewing_stage": true
      },
      {
        "id": "567e8901-e23c-45d6-e789-012345678901",
        "name": "Technical Interview",
        "stage_order": 3,
        "is_rejection_stage": false,
        "is_interviewing_stage": true
      },
      {
        "id": "678e9012-f34d-56e7-f890-123456789012",
        "name": "Offer",
        "stage_order": 4,
        "is_rejection_stage": false,
        "is_interviewing_stage": false
      },
      {
        "id": "789e0123-a45b-67c8-d901-234567890123",
        "name": "Rejected",
        "stage_order": 5,
        "is_rejection_stage": true,
        "is_interviewing_stage": false
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Body

application/json
​
title
string
required

Job title (required). E.g. "Senior Software Engineer".

Minimum string length: 1
​
company_name
string

Client company name. At least one of company_name, company_domain, or company_linkedin_url required.

​
company_domain
string

Client company website domain (e.g. "acme.com"). Used for matching or creating the company.

​
company_linkedin_url
string<uri>

Client company LinkedIn URL. Used for matching or creating the company.

​
pipeline_template_name
string

Pipeline template name to use. Defaults to "Default Template" if omitted.

​
team_members
object[]

Team members to assign with their roles.

​
job_description
string

Plain-text or HTML job description.

​
location
string

Job location (e.g. "San Francisco, CA").

​
primary_url
string<uri>

Primary job posting URL.

​
currency_code
string

ISO 4217 currency code (e.g. "USD", "EUR", "GBP").

Pattern: ^[A-Z]{3}$
​
job_function
string

Department or function (e.g. "Engineering", "Marketing").

​
open_date
string

Job opening date (YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
​
end_date
string

Target close date (YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
​
salary_min
integer

Minimum annual salary.

Required range: x >= 0
​
salary_max
integer

Maximum annual salary.

Required range: x >= 0
​
fee
number

Placement fee amount.

Required range: x >= 0
​
firm_commission_percent
number

Firm commission percentage of the placement fee (0–100).

Required range: 0 <= x <= 100

Response

Job created

​
success
enum<boolean>
required
Available options:
true
​
data
object
required