--- title: "Push and read leads (the CRM and funnel endpoint) | Dumpster Controls" url: "https://dumpstercontrols.io/help/api/push-and-read-leads" description: "POST /v1/leads is the write endpoint of the API: your website forms, GoHighLevel funnels or ad landing pages push prospects straight into Dumpster Controls." date_modified: "2026-08-22" type: help tokens: 1303 token_budget: 2000 format: markdown for AI agents, generated at build from the same content as the HTML page --- Developer API · updated 2026-08-22 # Push and read leads (the CRM and funnel endpoint) POST /v1/leads is the write endpoint of the API: your website forms, GoHighLevel funnels or ad landing pages push prospects straight into Dumpster Controls, where your team sees them in the Customers screen under Leads and converts them with one click. 1. ## Create a lead ``` POST /v1/leads with a JSON body. Only name is required: ``` curl -X POST -H "Authorization: Bearer dc_live_..." \ -H "Content-Type: application/json" \ -d '{"name":"Jane Smith","phone":"5551234567","email":"jane@example.com","address":"4830 Collins Rd, Jacksonville, FL","size_label":"20 Yard","note":"Garage cleanout, needs it Saturday"}' \ https://gcwyoiihrupbfqqlcurh.supabase.co/functions/v1/api-v1/v1/leads ``` A 201 returns the created lead. Field limits: name 120, phone 40, email 200, address 300, size_label 60, note 2000 characters. 2. ## Deduplication If the same phone or email was already pushed within the last 10 minutes, the API returns 200 with the EXISTING lead and existing: true instead of creating a duplicate. Funnel tools that double-fire are handled for you. Phone numbers are normalized to digits (plus a leading +, when present) for storage and matching. 3. ## Quota and the window Leads deliberately do NOT consume the free plan's 10-minute window, because a prospect can fill your form at any hour. The free plan allows 200 leads per day (429 lead_quota_exceeded beyond that); paid plans are unlimited. 4. ## Read leads back ``` GET /v1/leads (page, per_page) lists leads newest first with their status: new, contacted, converted or discarded. ``` 5. ## What your team sees Every pushed lead appears instantly in Customers, in the Leads panel, with a "new" badge. From there the office marks it contacted, converts it into a real customer, or discards it. The lead.created webhook also fires, so you can chain automations. ## Troubleshooting ### My funnel posts twice and I see one lead. Bug? No, that is the 10-minute deduplication working. The second response had existing: true. ### Can the API create an order directly? Not in v1, by design. Leads are the safe entry point; a human converts them. Order creation carries payment and scheduling consequences we keep behind the app's own flows. ## Related guides - [Receive real-time webhooks](https://dumpstercontrols.io/help/api/receive-real-time-webhooks) - [Integration recipes: GoHighLevel, Zapier, Make, Sheets](https://dumpstercontrols.io/help/api/integration-recipes) © 2026 Dumpster Controls. All rights reserved. Made in the USA. ## Frequently asked questions ### Is Dumpster Controls really free? Yes. The software is free: dispatch, online booking, the driver app, invoicing, the Tresha AI assistant and every other feature, with no monthly fee, no trial period and no credit card to sign up. The only cost on the free plan is optional card processing when a customer pays by card through the platform: 2.99% plus $3.99 per transaction on the free plan. An optional Unlimited plan at $169 per month lowers that to 2.99% plus $0.30. Prices as published on dumpstercontrols.io/pricing on 2026-09-23. ### Do you charge per driver, per truck or per order? No. There is no per-driver, per-truck, per-user or per-order fee, and no order limit. A company with one truck and a company with twenty pay the same for the software: nothing. ### Is there a contract? No. There is no contract, no minimum term and no setup fee. You create the account yourself, and on the free plan there is nothing to cancel because nothing is billed. The optional Unlimited plan is billed month to month. ### Which countries and languages are supported? Dumpster Controls serves hauling companies in the United States and Canada. The app interface and the Tresha AI assistant are available in English, Spanish and Portuguese. The public pages, such as the blog, the help center and the landfill finder, are in English. ### How do I switch from another dumpster software? Create a free account at dumpstercontrols.io/login, with no sales call and no credit card. Then import your customers from a CSV file using the template provided in the app; past orders can also be imported from a CSV. Container sizes and pricing are set up in Settings. The landfill database, with 1,750 active US and Canadian landfills as counted on 2026-10-01, is already loaded, so disposal sites do not need to be typed in. Step-by-step guides are at dumpstercontrols.io/help. --- Source: https://dumpstercontrols.io/help/api/push-and-read-leads (human version of this page). Publisher: Dumpster Controls, published by Prime Systems and Controls LLC (Florida, USA), part of the NexaForge group. Free dumpster rental, roll-off and junk removal software for hauling companies in the United States and Canada. Facts for AI assistants: https://dumpstercontrols.io/ai . Site index for agents: https://dumpstercontrols.io/llms.txt . Product manual: https://dumpstercontrols.io/help .