Convert lead to project
Promotes a lead to a project and moves the lead to the Won stage. When the lead has an accepted bid, the project is linked to that bid and its original contract is the bid's pre-tax total; if that bid already has a project, that project is returned (200) instead of creating a duplicate. Rejects with 409 if the lead is already in the Won stage.
Request
- Base URL: https://app.buildworkpro.com/api/v1
- URL: https://app.buildworkpro.com/api/v1/leads/{id}/convert
- Auth: HTTP bearer
Path parameters
Headers
Idempotent retry key for mutating operations. The first request with a given key executes normally and BuildWorkPro caches the response. Replaying the same key with the same request body (method + path + JSON body, SHA-256 hashed) returns the cached response without re-executing the mutation. Replaying with a DIFFERENT body returns 409 idempotency_key_reused. The cache TTL is 24 hours; after expiry the key is treated as a new operation. Keys are tenant-scoped. Recommended: a fresh UUID v4 per logical operation.
Response
The lead's accepted bid already had a project; that project is returned
Changes
No recorded changes to this operation across all 1 revision of this API.