CurbWaste API Quickstart: Create Your First Customer Record

Make your first partner API call against the customers API.

Get your API key

In the Developer Platform API Keys page, create a key with customers:read and customers:write. Copy the cw_live_… secret once.

export CURBWASTE_API_KEY="cw_live_YOUR_API_KEY"

Details: Authentication.

Create a customer

Only displayName is required. Optional: email, phone, companyName.

curl -X POST "https://api.curbwaste.com/v1/customers" \
  -H "Authorization: Bearer $CURBWASTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"displayName":"Acme Corp","email":"billing@acme.com","phone":"555-0100"}'

201 response shape:

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "displayName": "Acme Corp",
    "customerId": "C001",
    "status": "active",
    "email": "billing@acme.com",
    "phone": "555-0100",
    "companyName": null,
    "createdAt": "2026-08-07T18:00:00.000Z",
    "updatedAt": "2026-08-07T18:00:00.000Z"
  }
}

Save data.id for the next step. If you registered a webhook, you should also receive customer.created.

Get the customer

curl "https://api.curbwaste.com/v1/customers/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer $CURBWASTE_API_KEY"

Expect 200 with the same profile. Cross-company or unknown ids return 404.

What to do next

Keep customers in sync

Create, update, and join records using CurbWaste id as your source of truth.

Get events in real time

Connect an AI agent

Point an MCP-compatible client at CurbWaste with the same API key scopes.

⌘I

Get Started

Core Concepts

Guides

API overview

CurbWaste API Quickstart: Create Your First Customer Record

What to do next

Keep customers in sync

Get events in real time

Connect an AI agent

​What to do next

Keep customers in sync

Get events in real time

Connect an AI agent

What to do next