# Leonar API

## Docs

- [Add a note to a company](https://leonar.mintlify.app/api-reference/companies/add-a-note-to-a-company.md)
- [Archive a company](https://leonar.mintlify.app/api-reference/companies/archive-a-company.md)
- [Create a company](https://leonar.mintlify.app/api-reference/companies/create-a-company.md)
- [Get a company](https://leonar.mintlify.app/api-reference/companies/get-a-company.md): Returns company details with contact and deal counts.
- [List companies](https://leonar.mintlify.app/api-reference/companies/list-companies.md)
- [List company contacts](https://leonar.mintlify.app/api-reference/companies/list-company-contacts.md)
- [List company custom field definitions](https://leonar.mintlify.app/api-reference/companies/list-company-custom-field-definitions.md): Returns the workspace custom field definitions available for companies.
- [List company deals](https://leonar.mintlify.app/api-reference/companies/list-company-deals.md)
- [List company notes](https://leonar.mintlify.app/api-reference/companies/list-company-notes.md)
- [Update a company](https://leonar.mintlify.app/api-reference/companies/update-a-company.md): Updates an existing company.
- [List connected accounts](https://leonar.mintlify.app/api-reference/connected-accounts/list-connected-accounts.md): Returns active LinkedIn accounts connected to the workspace.
- [Add a note to a contact](https://leonar.mintlify.app/api-reference/contacts/add-a-note-to-a-contact.md)
- [Add a tag to a contact](https://leonar.mintlify.app/api-reference/contacts/add-a-tag-to-a-contact.md)
- [Archive a contact](https://leonar.mintlify.app/api-reference/contacts/archive-a-contact.md): Archives a contact by setting `archived_at`. Archived contacts are excluded from list queries by default.
- [Create a contact](https://leonar.mintlify.app/api-reference/contacts/create-a-contact.md): Creates a new contact in the workspace.
- [Delete a contact CV](https://leonar.mintlify.app/api-reference/contacts/delete-a-contact-cv.md): Removes the current CV from a contact.
- [Enrich a contact](https://leonar.mintlify.app/api-reference/contacts/enrich-a-contact.md): Triggers enrichment to find email or phone number for a contact.
- [Get a contact](https://leonar.mintlify.app/api-reference/contacts/get-a-contact.md): Returns contact details including positions, pipeline entries, and active enrollments.
- [Get a contact CV](https://leonar.mintlify.app/api-reference/contacts/get-a-contact-cv.md): Returns the current CV metadata for a contact.
- [List contact custom field definitions](https://leonar.mintlify.app/api-reference/contacts/list-contact-custom-field-definitions.md): Returns the workspace custom field definitions available for contacts.
- [List contact notes](https://leonar.mintlify.app/api-reference/contacts/list-contact-notes.md): Returns contact notes. By default this lists only global contact notes; pass `project_id` to scope the listing to notes attached to that contact within a specific project.
- [List contacts](https://leonar.mintlify.app/api-reference/contacts/list-contacts.md): Returns a paginated list of contacts. Archived contacts are excluded by default.
- [Remove a tag from a contact](https://leonar.mintlify.app/api-reference/contacts/remove-a-tag-from-a-contact.md)
- [Search contacts](https://leonar.mintlify.app/api-reference/contacts/search-contacts.md): Advanced full-text search across contacts with combined filters.
- [Update a contact](https://leonar.mintlify.app/api-reference/contacts/update-a-contact.md): Updates an existing contact. Only specified fields are updated.
- [Upload or replace a contact CV](https://leonar.mintlify.app/api-reference/contacts/upload-or-replace-a-contact-cv.md): Uploads a CV file for a contact using multipart/form-data.
- [Get a conversation](https://leonar.mintlify.app/api-reference/conversations/get-a-conversation.md)
- [List conversations](https://leonar.mintlify.app/api-reference/conversations/list-conversations.md)
- [List messages](https://leonar.mintlify.app/api-reference/conversations/list-messages.md)
- [Send a message in a conversation](https://leonar.mintlify.app/api-reference/conversations/send-a-message-in-a-conversation.md)
- [List deal pipelines](https://leonar.mintlify.app/api-reference/deal-pipelines/list-deal-pipelines.md): Returns all deal pipelines with their stages.
- [Add a note to a deal](https://leonar.mintlify.app/api-reference/deals/add-a-note-to-a-deal.md)
- [Archive a deal](https://leonar.mintlify.app/api-reference/deals/archive-a-deal.md)
- [Close a deal](https://leonar.mintlify.app/api-reference/deals/close-a-deal.md): Closes a deal as won, lost, or unqualified. Lost and unqualified deals require a matching close reason, while won deals must not send one.
- [Create a deal](https://leonar.mintlify.app/api-reference/deals/create-a-deal.md)
- [Create a deal from intake data](https://leonar.mintlify.app/api-reference/deals/create-a-deal-from-intake-data.md): Creates or reuses a company and contact, then creates a new deal in the requested stage. Company deduplication checks existing records by LinkedIn URL, domain, then name. Contact deduplication checks existing records by LinkedIn profile, email, then name + company.
- [Get a deal](https://leonar.mintlify.app/api-reference/deals/get-a-deal.md): Returns deal details with company, stage, and linked contacts.
- [Link a contact to a deal](https://leonar.mintlify.app/api-reference/deals/link-a-contact-to-a-deal.md)
- [List deal contacts](https://leonar.mintlify.app/api-reference/deals/list-deal-contacts.md)
- [List deal notes](https://leonar.mintlify.app/api-reference/deals/list-deal-notes.md)
- [List deals](https://leonar.mintlify.app/api-reference/deals/list-deals.md)
- [Move deal to a stage](https://leonar.mintlify.app/api-reference/deals/move-deal-to-a-stage.md): Moves a deal to a different pipeline stage. The deal must be open and the stage must belong to the same pipeline.
- [Reopen a deal](https://leonar.mintlify.app/api-reference/deals/reopen-a-deal.md): Reopens a closed deal, setting status back to `open`.
- [Unlink a contact from a deal](https://leonar.mintlify.app/api-reference/deals/unlink-a-contact-from-a-deal.md)
- [Update a deal](https://leonar.mintlify.app/api-reference/deals/update-a-deal.md)
- [Get enrichment status](https://leonar.mintlify.app/api-reference/enrichment/get-enrichment-status.md): Poll the status of an enrichment request.
- [API Reference](https://leonar.mintlify.app/api-reference/introduction.md): Complete reference for all Leonar API endpoints.
- [Send a message to a contact](https://leonar.mintlify.app/api-reference/messages/send-a-message-to-a-contact.md): Sends a message to a contact. Creates a conversation if one doesn't exist.
- [Delete a note](https://leonar.mintlify.app/api-reference/notes/delete-a-note.md)
- [Get a note](https://leonar.mintlify.app/api-reference/notes/get-a-note.md)
- [Update a note](https://leonar.mintlify.app/api-reference/notes/update-a-note.md)
- [Get a pipeline entry](https://leonar.mintlify.app/api-reference/pipeline-entries/get-a-pipeline-entry.md)
- [Remove from pipeline](https://leonar.mintlify.app/api-reference/pipeline-entries/remove-from-pipeline.md)
- [Update a pipeline entry](https://leonar.mintlify.app/api-reference/pipeline-entries/update-a-pipeline-entry.md): Updates a pipeline entry.
- [Add contact to pipeline](https://leonar.mintlify.app/api-reference/projects/add-contact-to-pipeline.md): Adds an existing contact to a project's pipeline.
- [Archive a project](https://leonar.mintlify.app/api-reference/projects/archive-a-project.md)
- [Create a project](https://leonar.mintlify.app/api-reference/projects/create-a-project.md)
- [Get a project](https://leonar.mintlify.app/api-reference/projects/get-a-project.md): Returns project details including pipeline stages and entry counts.
- [List pipeline entries](https://leonar.mintlify.app/api-reference/projects/list-pipeline-entries.md): Returns candidates in a project's pipeline. The project is always scoped by the `{id}` path parameter. To narrow the result to one pipeline stage within that project, pass the stage UUID in the `stage_id` query parameter.
- [List projects](https://leonar.mintlify.app/api-reference/projects/list-projects.md)
- [Update a project](https://leonar.mintlify.app/api-reference/projects/update-a-project.md)
- [Enroll contacts](https://leonar.mintlify.app/api-reference/sequences/enroll-contacts.md): Enrolls contacts in a sequence. Skips contacts that are blacklisted, already enrolled, or active in another sequence.
- [Get a sequence](https://leonar.mintlify.app/api-reference/sequences/get-a-sequence.md): Returns sequence details with steps and enrollment counts.
- [List enrolled contacts](https://leonar.mintlify.app/api-reference/sequences/list-enrolled-contacts.md)
- [List sequences](https://leonar.mintlify.app/api-reference/sequences/list-sequences.md)
- [Unenroll contacts](https://leonar.mintlify.app/api-reference/sequences/unenroll-contacts.md): Removes contacts from a sequence.
- [Add profiles to project](https://leonar.mintlify.app/api-reference/sourcing/add-profiles-to-project.md): Add sourcing profiles to a project's pipeline with automatic deduplication.
- [Advance Sourcing API endpoint — search profiles](https://leonar.mintlify.app/api-reference/sourcing/advance-sourcing-api-endpoint-—-search-profiles.md): Advanced sourcing endpoint for finding professional profiles through Leonar's extended sourcing network. Use this endpoint when your integration needs high-volume sourcing through a stable Leonar API contract — the underlying provider is abstracted by Leonar and may evolve without affecting your int…
- [Get LinkedIn company](https://leonar.mintlify.app/api-reference/sourcing/get-linkedin-company.md): Fetch full details of a LinkedIn company profile via a connected account.
- [Get LinkedIn profile](https://leonar.mintlify.app/api-reference/sourcing/get-linkedin-profile.md): Fetch full details of a LinkedIn profile via a connected account.
- [Search candidates](https://leonar.mintlify.app/api-reference/sourcing/search-candidates.md): Search candidates in the Leonar database or via LinkedIn.
- [Search CRM contacts](https://leonar.mintlify.app/api-reference/sourcing/search-crm-contacts.md): Search internal CRM contacts with flat filters.
- [Search LinkedIn companies](https://leonar.mintlify.app/api-reference/sourcing/search-linkedin-companies.md): Search LinkedIn companies via a connected account. Useful for prospecting and market research.
- [Search LinkedIn jobs](https://leonar.mintlify.app/api-reference/sourcing/search-linkedin-jobs.md): Search LinkedIn job postings via a connected account. Useful for business development and market intelligence.
- [Search LinkedIn locations](https://leonar.mintlify.app/api-reference/sourcing/search-linkedin-locations.md): Search locations for LinkedIn search filters. This is a required step before using `location_ids` in any LinkedIn search endpoint. Pass a city, region, or country name as `q` and use the returned `id` values in the `location_ids` parameter of search requests.
- [Search LinkedIn posts](https://leonar.mintlify.app/api-reference/sourcing/search-linkedin-posts.md): Search LinkedIn posts via a connected account. Useful for social selling and content monitoring.
- [Search LinkedIn profiles](https://leonar.mintlify.app/api-reference/sourcing/search-linkedin-profiles.md): Search LinkedIn profiles via a connected account. Flat schema — no nested `filters` object.
- [Search locations](https://leonar.mintlify.app/api-reference/sourcing/search-locations.md): Search locations for LinkedIn search filters.
- [Search people database](https://leonar.mintlify.app/api-reference/sourcing/search-people-database.md): Search Leonar's external people database with flat filters.
- [Create a tag](https://leonar.mintlify.app/api-reference/tags/create-a-tag.md)
- [Delete a tag](https://leonar.mintlify.app/api-reference/tags/delete-a-tag.md): Permanently deletes a tag and removes all associations.
- [List tags](https://leonar.mintlify.app/api-reference/tags/list-tags.md)
- [Create a task](https://leonar.mintlify.app/api-reference/tasks/create-a-task.md)
- [Delete a task](https://leonar.mintlify.app/api-reference/tasks/delete-a-task.md)
- [Get a task](https://leonar.mintlify.app/api-reference/tasks/get-a-task.md)
- [List tasks](https://leonar.mintlify.app/api-reference/tasks/list-tasks.md)
- [Update a task](https://leonar.mintlify.app/api-reference/tasks/update-a-task.md): Update task fields. Setting `status` to `done` automatically sets `completed_at`.
- [Authentication](https://leonar.mintlify.app/authentication.md): Authenticate your API requests with Bearer tokens.
- [Errors](https://leonar.mintlify.app/errors.md): Error codes and how to handle them.
- [AI Agent Integration](https://leonar.mintlify.app/guides/ai-agents.md): Build AI agents that autonomously operate on Leonar CRM data using the API.
- [Boolean Search](https://leonar.mintlify.app/guides/boolean-search.md): Use boolean queries to build precise LinkedIn and database sourcing searches.
- [Custom fields](https://leonar.mintlify.app/guides/custom-fields.md): Read field definitions and manage custom field values on contacts and companies.
- [MCP Server](https://leonar.mintlify.app/guides/mcp-server.md): Connect Claude Code, Claude Desktop, Cursor, Codex, or any MCP client directly to Leonar using the Model Context Protocol.
- [Quickstart](https://leonar.mintlify.app/guides/quickstart.md): Build your first Leonar integration in 5 minutes.
- [Scopes](https://leonar.mintlify.app/guides/scopes.md): Choose the right permissions for your API key.
- [Workflow Recipes](https://leonar.mintlify.app/guides/workflows.md): Step-by-step API workflows for common recruiting operations.
- [Introduction](https://leonar.mintlify.app/introduction.md): Build AI agents and integrations on top of Leonar CRM.
- [Pagination](https://leonar.mintlify.app/pagination.md): Navigate through large datasets with offset-based pagination.
- [Rate limiting](https://leonar.mintlify.app/rate-limiting.md): Understand API rate limits and how to handle them.

## OpenAPI Specs

- [openapi](https://leonar.mintlify.app/openapi.yaml)