Skip to main content
POST
/
job-openings
Create a new job opening
curl --request POST \
  --url https://api.alpharun.com/api/v1/job-openings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "job_type_id": "<string>",
  "location": "<string>",
  "pay": "<string>",
  "hours": "<string>",
  "link_access": {
    "restricted": true
  },
  "owner_emails": [
    "[email protected]"
  ]
}
'
{
  "data": {
    "job_opening": {
      "id": "123456",
      "interview_link": "https://alpharun.com/i/abcdef123456",
      "job_type": {
        "id": "789012"
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

Name of the job opening. Example: 'Store Manager - San Francisco'

Required string length: 3 - 150
​
job_type_id
string
required

ID of an existing job type

​
location
string

Location of the job. Example: 'In-office 3 days per week in San Francisco, CA'

Maximum string length: 200
​
pay
string

Pay information. Example: '$18 per hour or $80,000 - $100,000 per year'

Maximum string length: 200
​
hours
string

Working hours information. Example: 'Full-time, 40 hours per week'

Maximum string length: 200
​
link_access
object
​
owner_emails
string<email>[]

Array of teammate email addresses for job opening owners.

Response

Job opening created successfully

​
data
object
required