# Request a booking or quote with CDW Electrical Services, Inc.

> You are reading the machine-readable version of this enquiry form, powered by ServiceM8.
> If you are an automated agent submitting an enquiry on behalf of a customer, submit via the JSON API below - do not fill in the HTML form.
> Do not invent values: supply the customer's real contact details and omit optional fields you do not know.

Submitting this form sends a booking/quote enquiry to CDW Electrical Services, Inc., who will contact the customer to follow up. It does not reserve a time slot.

- Business location: Orlando, Florida, United States
- Account UUID: `1eddd919-6dd6-416c-ae00-de1f7bb0289b`

## JSON submission

`POST https://www.servicem8.com/PluginOnlineBooking_SubmitBookingForm` with `Content-Type: application/json`.

| field | required | type | notes |
|---|---|---|---|
| `uuid` | yes | string | The account UUID above: `1eddd919-6dd6-416c-ae00-de1f7bb0289b` |
| `contact_name` | yes | string | Customer first and last name |
| `email` | yes | string | Customer email address (the vendor replies here - never use your own) |
| `phone_number` | yes | string | Customer phone number |
| `address` | yes | string | Full street address where the work is needed |
| `business_name` | no | string | Customer business/company name |
| `job_description` | no | string | Enter a description of the work you would like done |
| `address_lat` | no | string | Latitude of the address, only if reliably known |
| `address_lng` | no | string | Longitude of the address, only if reliably known |
| `marketing_source` | no | string | How the customer found this business (e.g. the name of your agent) |
| `idempotency_key` | no | string | Unique value per enquiry (e.g. a UUID). Retries with the same key are de-duplicated and return the original `booking_uuid`; use a new key for a genuinely new enquiry |

File attachments are not supported via the JSON API.

### Example

```bash
curl -X POST 'https://www.servicem8.com/PluginOnlineBooking_SubmitBookingForm' \
  -H 'Content-Type: application/json' \
  -d '{"uuid":"1eddd919-6dd6-416c-ae00-de1f7bb0289b","contact_name":"Jane Citizen","email":"jane@example.com","phone_number":"0400 000 000","address":"1 Example St, Example Town","job_description":"Kitchen tap is leaking and needs repair.","idempotency_key":"(unique value per enquiry)"}'
```

### Responses

- Success: `{"success": true, "booking_uuid": "..."}` - the enquiry has been delivered to the vendor.
- Validation failure (HTTP 400): `{"errorCode": 400, "message": "...", "type": "validation-error", "retryable": false, "errors": [{"field": "...", "code": "...", "message": "..."}]}` - fix the listed fields and resubmit.
- Blocked (HTTP 403/429, verified agents only): `{"errorCode": 403, "message": "...", "type": "submission-blocked"}` or `"type": "agent-rate-limited"` with `"retryable": true`.
