Quickstart
Make your first API call in under 5 minutes
Quickstart
This guide walks you through making your first Jobiflow API call in minutes.
Prerequisites
- A Jobiflow company account
- An API key (see Authentication)
1. Create an API Key
In the Jobiflow dashboard, go to Settings → API Keys and create a new key with the jobs:read scope, or use the API:
curl -X POST https://api.jobiflow.com/settings/api-keys \
-H "Authorization: Bearer <oauth2_token>" \
-H "Content-Type: application/json" \
-d '{
"label": "My First Integration",
"scopes": ["jobs:read", "applications:read"],
"expiresAt": "2027-01-01T00:00:00Z"
}'Copy the rawKey from the response — it won't be shown again.
2. List Your Job Listings
curl https://api.jobiflow.com/public/v1/job-listings \
-H "X-API-Key: <your_api_key>"Response:
{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "ACTIVE",
"position": { "value": "Senior Engineer", "translated": false },
"positionType": "FULL_TIME",
"workPlaceType": "HYBRID",
"createdAt": "2026-05-01T09:00:00Z"
}
],
"pagination": {
"page": 0,
"size": 20,
"totalElements": 1,
"totalPages": 1
}
}3. Create a Job Listing
curl -X POST https://api.jobiflow.com/public/v1/job-listings \
-H "X-API-Key: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"position": "Backend Developer",
"positionType": "FULL_TIME",
"workPlaceType": "REMOTE",
"currency": "EUR",
"salaryBase": 70000,
"paymentInterval": "YEARLY"
}'4. Publish It
curl -X POST https://api.jobiflow.com/public/v1/job-listings/<id>/publish \
-H "X-API-Key: <your_api_key>"