API Docs
Build on top of Jobby
Connect Jobby to your internal tools, build custom workflows, and automate your entire operation. Our REST API and webhooks make it easy.
REST API
A clean, predictable REST API for every resource in Jobby. JSON in, JSON out.
Webhooks
Get real-time notifications when jobs, invoices, or payments change. Subscribe to the events you care about.
API keys
Generate and rotate API keys from your dashboard. Scope each key to the permissions it needs.
SDKs and examples
Official SDKs for JavaScript and Python, plus code examples for every endpoint.
Quick start
Make your first API call in under 5 minutes.
1. Generate an API key
A clean, predictable REST API for every resource in Jobby. JSON in, JSON out.
2. Make your first request
Use your API key in the Authorization header. Here's how to list your jobs:
curl https://api.jobby.com/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
That's it. You'll get a JSON array of your jobs back.
Core endpoints
GET /api/v1/jobs
List all jobs with optional filters by status, worker, or client.
POST /api/v1/jobs
Create a new job and assign it to a worker.
GET /api/v1/invoices
List invoices with optional filters by status or date range.
POST /api/v1/invoices
Create and optionally send an invoice.
GET /api/v1/clients
List all clients with their job and payment history.
GET /api/v1/workers
List workers and their current availability status.
Real-time webhooks
Subscribe to events and we'll POST to your endpoint the moment they happen.
- job.created
- job.status_changed
- invoice.created
- invoice.sent
- invoice.paid
- invoice.overdue
- payment.received
- client.created
API questions
How do I get an API key?
Go to Settings → API in your Jobby dashboard and click 'Generate new key'. Choose the scopes your integration needs and copy the key — it's shown only once for security.
Is there a rate limit?
Yes. The API allows 100 requests per minute per API key. If you need higher limits for a production integration, contact our team and we'll work with you.
What authentication does the API use?
The Jobby API uses Bearer token authentication. Include your API key in the Authorization header of every request: 'Authorization: Bearer YOUR_API_KEY'.
Are there SDKs available?
Yes. We offer official SDKs for JavaScript and Python, plus community-contributed SDKs for other languages. All SDKs are open source on GitHub.