GoHighLevel API reference
Contacts API
The GoHighLevel Contacts API has 15 documented endpoints here, covering DELETE, GET, POST and PUT requests. Contacts are the record every other GoHighLevel object hangs off — opportunities, conversations, and appointments all reference one. These endpoints create and update them, manage tags and followers, and attach notes and tasks.
Every page below carries the full parameter list, the response shape, the OAuth scope, and a curl you can paste into a terminal. Base URL: https://services.leadconnectorhq.com
All contacts endpoints
| Endpoint | Method | Path | Scope |
|---|---|---|---|
| Add Followers Contact | POST | /contacts/:contactId/followers | contacts.write |
| Add Remove Contact From Business | POST | /contacts/bulk/business | — |
| Add Tags | POST | /contacts/:contactId/tags | contacts.write |
| Create Association | POST | /contacts/bulk/tags/update/:type | — |
| Create Contact | POST | /contacts/ | contacts.write |
| Create Note | POST | /contacts/:contactId/notes | contacts.write |
| Create Task | POST | /contacts/:contactId/tasks | contacts.write |
| Get Contactsdeprecated | GET | /contacts/ | contacts.readonly |
| Get Duplicate Contact | GET | /contacts/search/duplicate | contacts.readonly |
| Remove Followers Contact | DELETE | /contacts/:contactId/followers | contacts.write |
| Remove Tags | DELETE | /contacts/:contactId/tags | contacts.write |
| Update Contact | PUT | /contacts/:contactId | contacts.write |
| Update Note | PUT | /contacts/:contactId/notes/:id | contacts.write |
| Update Task | PUT | /contacts/:contactId/tasks/:taskId | contacts.write |
| Upsert Contact | POST | /contacts/upsert | contacts.write |
Skip the schema lookup
Hylo hands these schemas to your AI agent over MCP, so it picks the right contacts endpoint and fills the body correctly the first time — then executes the call against your own sub-account when you approve it.
Elsewhere in the reference