HighLevel API
About Our Developer Documentation
HighLevel is currently in the process of moving to an OAuth 2.0-based API (API 2.0), and at some point in the future, this will be the only API available for integration once this migration is complete. Until this time, we have two APIs, which we are calling the API 1.0 and the API 2.0 for added clarity when referencing which API you are utilizing. See further details below.
API 1.0 Docs
https://public-api.gohighlevel.com/
- No new endpoints are planned for the Public API at this time.
- “Public API (v1)” has been renamed to API 1.0 for clarity.
API 2.0 Docs
https://highlevel.stoplight.io/docs/integrations/0443d7d1a4bd0-overview
- Going forward, be sure to use the API 2.0 Docs for new integrations as all future endpoints and new API functionality will be added here.
- As of now, not all endpoints from the API 1.0 Docs have been integrated into the API 2.0 Docs.
- Pro Tip: To ensure an uninterrupted API integration, be sure to regularly review and update your integration as soon as a new endpoint becomes available in the API 2.0 Docs.
- “OAuth 2.0 API (v2)” has been renamed to API 2.0 for clarity.
Check out our Developers Landing Page, where you can find the Developer Marketplace, Documentation, Slack Channel, and more! –> https://developers.gohighlevel.com/
TABLE OF CONTENTS
How to Get Help or Support for the HighLevel API
How to Submit a New API-Related Idea to HighLevel
Differences Between API Access Across Plan Levels
What is an API Key and how is it used?
What are the API Rate Limits for API 1.0 & 2.0?
Where To Find The Agency & Location API Keys
1. Location Level > Settings > Business Info
2. Agency Level > Agency Settings > API Keys to view all Location API keys in one place
Troubleshooting
How to Get Help or Support for the HighLevel API
- For any questions relating to the HighLevel API, join the developer Slack group to ask our community of talented customers here: https://www.gohighlevel.com/dev-slack
- HighLevel Devs host a monthly a Developer Council Call on the second to last Friday, which you can find on the events calendar here: https://www.gohighlevel.com/events
How to Submit a New API-Related Idea to HighLevel
Differences Between API Access Across Plan Levels
Basic API access is included with our Starter and Unlimited plans, while Advanced API access is available on our Agency Pro plan.
In addition to the future endpoints that will be released in our OAuth 2.0 API (which is only available in our Advanced API access), this tier unlocks the use of Agency API Keys where lower plan levels only access Location API Keys.
What is an API Key and how is it used?
An authorized API key will allow you to pass data between software automatically using applications like Zapier, Pabbly, Integrately, Make (Formerly Integromat), API Nation, and others.
Where To Find The Agency & Location API Keys
Where to find the Location Level API Key?
1. Location Level > Settings > Business Info
2. Agency Level > Agency Settings > API Keys to view all Location API keys in one place
What are the Rate Limits for API 1.0 & API 2.0?
Our current rate limits for API 1.0 are:
For Burst Requests – 100/10 seconds
For Daily – 200,000/Day
Our current rate limits for API 2.0 are:
GHL has implemented rate limits on our public V2 APIs using OAuth to ensure optimal performance and stability. These limits have been adjusted to:
Burst limit: A maximum of 100 API requests per 10 seconds for each Marketplace app (i.e., client) per resource (i.e., Location or Company).
Daily limit: 200,000 API requests per day for each Marketplace app (i.e., client) per resource (i.e., Location or Company).
These new limits contribute to better overall performance and stability of our system.
To monitor your limited usage, refer to the following API response headers:
‘X-RateLimit-Limit-Daily’: Your daily limit
‘X-RateLimit-Daily-Remaining’: The remaining number of requests for the day
‘X-RateLimit-Interval-Milliseconds’: The time interval for burst requests
‘X-RateLimit-Max’: The maximum request limit in the specified time interval
‘X-RateLimit-Remaining’: The remaining number of requests in the current time interval