Developer Platform

Build on the CrewBox API

CrewBox comes with a full REST API that gives you programmatic access to every feature in the platform — projects, photos, tasks, documents, reports, and more. Build integrations, automate your workflows, and connect CrewBox to the tools your crew already uses.

Get API Access

curl https://api.crewbox.pro/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY"

One API for every feature

Everything you can do in the CrewBox app, you can do through the API.

Projects

Create, read, update, and organize projects — including addresses, crew assignments, tags, and cover photos.

Photos & Videos

Upload, fetch, and manage jobsite photos and videos, with GPS, timestamps, captions, and annotations.

Tasks

Create and assign tasks, set due dates, track completion, and attach photos programmatically.

Documents & Reports

Generate PDF reports, manage documents, and pull finished reports straight into your own systems.

Tags & Comments

Apply tags, read and post comments and @mentions to keep your integrations in sync with the field.

Users & Notifications

Manage crew members, roles, and access, and hook into notification events with webhooks.

API

The REST API

Every request hits a single base URL and is authenticated with a bearer token. Standard REST verbs, JSON in and JSON out, and predictable resource URLs for every object in CrewBox.

# List projects
GET https://api.crewbox.pro/v1/projects
Authorization: Bearer YOUR_API_KEY

# Response
{
  "data": [
    { "id": "prj_123", "name": "123 Main St", "status": "active" }
  ]
}

Webhooks

Register a URL and CrewBox POSTs a JSON payload to it the moment an event happens — no polling required. Every delivery is signed, so you can verify it came from us.

# CrewBox POSTs to your endpoint
POST https://your-app.com/webhooks/crewbox
X-CrewBox-Signature: sha256=…

{
  "event": "photo.created",
  "project_id": "prj_123",
  "data": { "id": "img_456", "url": "https://…" }
}

Subscribe to events like:

project.created     task.completed      photo.created
report.finished     comment.created     document.uploaded
project.updated     task.assigned       user.added

How access works

1. Request access

2. Get your API key

Receive a secret API key scoped to your workspace. Authenticate every request with a simple bearer token.

3. Start building

Call the REST endpoints, subscribe to webhooks, and ship your integration with our docs and support.