Webhooks
[CONFIRM — outbound webhooks are not documented in the current developer hub. Verify availability with engineering before publishing this card; until then, the Create Lead API covers inbound push use cases.]
Developers
Push leads into Getlead from any source, create tasks and deals programmatically, and keep statuses in sync — with simple token-authenticated POST endpoints and JSON responses.
Token auth·JSON responses·6 documented endpoints
Six documented endpoints: create leads, tasks, notes and deals, change a lead's status, and assign sources to departments. POST requests in, JSON out.
See the endpoints[CONFIRM — outbound webhooks are not documented in the current developer hub. Verify availability with engineering before publishing this card; until then, the Create Lead API covers inbound push use cases.]
Setup guides, how-tos and answers for everything in the product — the fastest route when your question isn't about code.
Open help centreThe API
All endpoints live under app.getleadcrm.com/api, accept POST requests, and return a JSON object with a status and a message. These are the endpoints documented today:
| Create lead | /api/gl-website-contacts |
|---|---|
| Create task | /api/gl-task-creation-api |
| Create note | /api/gl-note-creation-api |
| Change status | /api/gl-status-change-api |
| Create deal | /api/gl-deal-creation-api |
| Assign to department | /api/gl-department-vise-agent-assign/{token} |
Example: create a lead. For this endpoint, token, countrycode, mobileno and source are required; name, email, company_name, staff_name, department, status and custom additional fields are optional.
# Create a lead (POST — parameters passed as documented)
curl -X POST "https://app.getleadcrm.com/api/gl-website-contacts?token=YOUR_API_TOKEN&name=Asha%20Menon&countrycode=91&mobileno=9895000000&source=Website"
# Success response
{
"status": "success",
"message": "Lead Added Successfully."
}
# Error response (validation example)
{
"status": "fail",
"message": "The mobileno must be between 8 and 14 digits."
}
Authentication
Every request authenticates with an API token (prefixed gl_) passed as the token parameter. Generate yours inside the app:
token parameter.Treat the token like a password — it grants write access to your account's leads, tasks and deals. If it leaks, regenerate it from the same screen.
Rate limits
Getlead Standalone — the dedicated deployment for larger teams — comes with the highest API rate limits, along with a robust sandbox and enhanced disaster recovery. See plans and pricing for how Standalone differs from the standard plan.
[CONFIRM — standard-plan request limits are not published; have engineering supply the per-minute/per-day numbers before launch.]
FAQ
Generate it inside the Getlead app: open your profile dropdown, click Settings, choose GL Connect, open the API menu, then click the Show / generate token button and copy the token from the popup. Pass it as the token parameter on every request.
The documented APIs let you create leads, tasks, notes and deals, change a lead's status, and assign a source number to a department. Every endpoint accepts POST requests and returns a JSON object with a status and a message.
Getlead Standalone — the dedicated deployment for larger teams — comes with the highest API rate limits and a robust sandbox. Standard-plan limits are not published on this page; contact the team for the limits that apply to your account.
Yes. API access is part of the single plan at $9 per user per month billed yearly, or $12 billed monthly. Getlead Standalone, the dedicated deployment for larger teams, adds the highest rate limits and a robust sandbox.
Requests carry your API token, which you generate from your account. The same token works across every endpoint, so there is no separate credential per module — see the request example above for the exact header to send.
Yes. Leads created through the API land in the same queue as leads from ads, forms and calls, with the same assignment rules and follow-up deadlines applied. Nothing has to be reconciled afterwards because there is only one queue.
Start with the error the endpoint returns — it names the field or permission at fault. If you are still stuck, the support team is reachable by phone, WhatsApp and email, and the people who answer work on the product.
Stuck on an integration? Check the help centre or contact the team.
The fastest reply usually wins the deal
Getlead catches the enquiry, alerts the right rep, and keeps every follow-up on track — so speed stops being luck.
No credit card required·Every feature unlocked·Cancel anytime