Update a company

Changes only the fields you send. To add people to a company, create them with its leadId (create a contact) or set leadId on existing contacts (update a contact).

Path parametersCopy Anchor Link

BodyCopy Anchor Link

Send a JSON object.

Example requestCopy Anchor Link

curl -X PATCH "https://api.pedibee.com/api/v1/leads/66f1c2a9e4b0a1b2c3d4e001" \
  -H "Authorization: Bearer $PEDIBEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "WARM",
    "lifecycleStage": "CONTACTED",
    "notes": "Met at SaaStr"
  }'

ResponseCopy Anchor Link

The updated company.

{
  "id": "66f1c2a9e4b0a1b2c3d4e001",
  "companyName": "Northwind",
  "domain": "northwind.io",
  "industry": "Software",
  "tier": "WARM",
  "lifecycleStage": "CONTACTED",
  "notes": "Met at SaaStr",
  "source": "MANUAL",
  "createdAt": "2026-10-05T09:30:00.000Z",
  "updatedAt": "2026-10-05T09:30:00.000Z"
}

ErrorsCopy Anchor Link

Every error is { "error": "…" } with a message you can show. See Errors and limits.