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://www.gohighlevel.com/?fp_ref=gohighlevele

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 Update your API Keys

• How do I know if my API Key is old?

• What will happen if my API key is compromised?

• What do I do if my API key is blank?

How to Get Help or Support for the HighLevel API

At this time, HighLevel Support does NOT provide setup code auditing or developer consultative services on API-Related topics. However, if your setup is complete and correct - yet an error persists, you may have encountered an API Bug we need to fix. 

You can report this bug by filling out this form: https://www.gohighlevel.com/?fp_ref=gohighlevele data-identifyelement="511" dir="ltr">
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/?fp_ref=gohighlevele"511" dir="ltr" style="font-size: 13px;">
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/?fp_ref=gohighlevele"511" dir="ltr">



How to Submit a New API-Related Idea to HighLevel
Our API Docs list all available endpoints that are publicly available. If you don’t see an endpoint on either of the API developer sites listed below, we recommend visiting our Roadmap & Ideas Board to add your idea! 

You can also track the progress of new ideas as they make their way through planning and into production on our roadmap. This board is both for new developer features and consumer features alike.





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 application programming interface key (API key) is a unique identifier used to authenticate a user, developer, or data passed via API. It's essentially a secret Key that you want to keep close and not share.

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



Troubleshooting
How to Update your API Keys
How do I know if my API Key is old?
What will happen if my API key is compromised?
What do I do if my API key is Undefined?