Service Jobs Webhook Events

Receive notifications when service jobs are created, updated, or when their status changes.

Events

Event	Description
`service_job.created`	A new service job was created
`service_job.status_changed`	A job's status changed
`service_job.completed`	A job was marked complete
`service_job.cancelled`	A job was cancelled

service_job.created

Triggered when a new service job is created.

Payload

{
    "event": "service_job.created",
    "timestamp": "2024-01-15T08:30:00Z",
    "data": {
        "id": 1,
        "company_id": 1,
        "job_number": "JOB-2024-0001",
        "customer_name": "John Doe",
        "customer_email": "[email protected]",
        "customer_phone": "+639171234567",
        "vehicle_make": "Toyota",
        "vehicle_model": "Camry",
        "vehicle_year": "2022",
        "vehicle_color": "White",
        "plate_number": "ABC 1234",
        "status": "pending",
        "scheduled_date": "2024-01-15",
        "scheduled_time": "09:00",
        "priority": "normal",
        "labor_cost": "0.00",
        "parts_cost": "0.00",
        "total_cost": "0.00",
        "is_paid": false,
        "created_at": "2024-01-15T08:30:00Z",
        "updated_at": "2024-01-15T08:30:00Z"
    }
}

service_job.status_changed

Triggered when a service job's status changes.

Payload

{
    "event": "service_job.status_changed",
    "timestamp": "2024-01-15T10:15:00Z",
    "data": {
        "id": 1,
        "job_number": "JOB-2024-0001",
        "previous_status": "pending",
        "new_status": "in_progress",
        "customer_name": "John Doe",
        "vehicle_make": "Toyota",
        "vehicle_model": "Camry",
        "plate_number": "ABC 1234",
        "changed_at": "2024-01-15T10:15:00Z"
    }
}

Status Values

Status	Description
`pending`	Job is scheduled but not started
`checked_in`	Vehicle has arrived
`in_progress`	Work is being performed
`on_hold`	Work is paused
`quality_check`	QC inspection in progress
`completed`	Job is finished
`cancelled`	Job was cancelled

service_job.completed

Triggered when a service job is marked as complete.

Payload

{
    "event": "service_job.completed",
    "timestamp": "2024-01-15T16:30:00Z",
    "data": {
        "id": 1,
        "company_id": 1,
        "job_number": "JOB-2024-0001",
        "customer_name": "John Doe",
        "customer_email": "[email protected]",
        "customer_phone": "+639171234567",
        "vehicle_make": "Toyota",
        "vehicle_model": "Camry",
        "plate_number": "ABC 1234",
        "labor_cost": "1500.00",
        "parts_cost": "2500.00",
        "total_cost": "4000.00",
        "is_paid": false,
        "completed_at": "2024-01-15T16:30:00Z"
    }
}

service_job.cancelled

Triggered when a service job is cancelled.

Payload

{
    "event": "service_job.cancelled",
    "timestamp": "2024-01-15T11:00:00Z",
    "data": {
        "id": 1,
        "job_number": "JOB-2024-0001",
        "customer_name": "John Doe",
        "vehicle_make": "Toyota",
        "vehicle_model": "Camry",
        "plate_number": "ABC 1234",
        "cancelled_at": "2024-01-15T11:00:00Z"
    }
}

Use Cases

Status Board Updates

Monitor service_job.status_changed to update real-time status boards in your shop.

Customer Notifications

Use service_job.completed to trigger SMS or email notifications to customers that their vehicle is ready.

Analytics & Reporting

Track all job events to build performance dashboards and identify bottlenecks in your workflow.