# Contacts

Contacts API

## Find one contact

 - [POST /leads/api/leads/lookup-one](https://api.getsales.io/api/openapi/contacts/findonecontact.md): Retrieve a single contact based on provided identification fields. You must supply at least one identifier—either a linkedin_id, an email, or both name and company_name together. linkedin_id could be an url or a nickname string.


## Search contacts

 - [POST /leads/api/leads/search](https://api.getsales.io/api/openapi/contacts/searchcontacts.md): Searches contacts using advanced filters, sorting, and pagination. Returns a list of matched contacts with optional aggregation.

### Supported Filter Value Types:

-  →  query
    

-  → Comparison query with operators
    

    Supported operators: , , `>="is_null"IS NULL"is_not_null"IS NOT NULL"linkedin_status": "ok"`


## Get contact by UUID

 - [GET /leads/api/leads/{uuid}](https://api.getsales.io/api/openapi/contacts/getlead.md): Get Contact by UUID

## Update contact by UUID

 - [PUT /leads/api/leads/{uuid}](https://api.getsales.io/api/openapi/contacts/updatelead.md): Update Contact by UUID

## Delete a Contact

 - [DELETE /leads/api/leads/{uuid}](https://api.getsales.io/api/openapi/contacts/deletelead.md): Delete a contact identified by its UUID. This operation dispatches a contact delete job that creates a mass action item and a delete payload indicating that the contact was manually deleted by the user.


## Create or Update a contact

 - [POST /leads/api/leads/upsert](https://api.getsales.io/api/openapi/contacts/upsertcontact.md): Creates or updates a contact in the specified list. If the contact exists and  is true, it will be updated. Optionally, the contact can also be moved to the specified list.