For companiesFor contractors
Home/Platform/Integrations & API

Your ticket creates the request. Updates flow back.

API keys with read or read-and-write scope, signed webhooks for every change, and a delivery log, so your service desk and PeerToSite stay in step.

Example · Your ticket creates the request
POST /api/v1/dispatch-requests
Idempotency-Key: INC0012345

{
  "site_code": "112",
  "service_item_id": "…",
  "urgency": "high",
  "title": "Exit sign dark",
  "reference": "INC0012345"
}
→ 201  {"id":"…", …}
Updates flow backaccepted · checked in · signed off · completed

What's in it

Integrations & API, in detail

REST API

Create a dispatch request from a ticket, read it, update it, comment in the job chat, cancel under the same rule as the button.

See it

Webhooks

Every change queued in the same transaction, HMAC-signed, tried up to six times, with a delivery log you can read.

ServiceNow Not live yet

A connector that writes work notes on the ticket is built but switched off until it has been tested against a real ServiceNow instance. Until then, use the API and webhooks.

Keys you control

Named keys, read-only or read-and-write, last-used shown, 120 requests a minute per key. A key works only while its creator is an active Company Manager.

Payloads

What a webhook carries

The job, its status, times and site — never a technician's name or contact details. Send an Idempotency-Key and the request is created once, however often your system retries.

  • dispatch.requested, accepted, checked_in, signed_off, completed, canceled…
  • Public https endpoints only, no redirects
  • Secrets encrypted at rest
Example · A webhook to your endpoint
X-PeerToSite-Event: dispatch.checked_in
X-PeerToSite-Delivery: 5f0c…
X-PeerToSite-Signature: sha256=3b1f…

{"event": "dispatch.checked_in",
 "sent_at": "2026-10-06T14:02:11+00:00",
 "dispatch_request": {
   "id": "…",
   "reference": "INC0012345",
   "status": "accepted",
   "checked_in_at": "2026-10-06T14:02:09+00:00", …}}
The job, its stage and times. Never a technician's name or contact details.

Questions

Things people ask

Is the ServiceNow connector live?

It's built and tested against a stand-in, not yet against a real instance. It's switched off on the deployed site until that test is done.

Can I post opportunities by API?

No. The API reads your postings; creating one, comparing bids and awarding happen in the app.

Who answers for our data in our ticket system?

Your company does: connecting a key or a webhook needs a responsibility tick, recorded in the audit log.

See it with your own sites

A 20-minute walkthrough with a real request.

Talk to us