*Workflows › Reference › Actions › Contacts*

# Find a contact

> Gets a contact by its ID or by its tax ID (NIF).

## At a glance

| Property | Value |
| --- | --- |
| Domain | `contacts` |
| Group in the editor | Contacts › Contacts |
| Runs as | The owner of the workflow, with their permissions |
| Permission | View access to at least one of: Contacts, CRM. Administrators always pass; a module outside the plan blocks everyone. |
| Destructive | No: the public MCP catalogue does not mark it as destructive |
| Also available in | REST API, MCP (`filmo_contacts_get`) |

ACTION `contacts.find`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `searchBy` | enum<string> | No |  `id`, `nif` = `id` |
| `id` | string | No |  |
| `nif` | string | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `id` | string |  |
| `name` | string |  |
| `contactType` | enum<string> |  `person`, `company` |
| `role` | enum<string> |  `client`, `provider`, `lead`, `debtor`, `creditor`, `student`, `teacher`, `unspecified` |
| `status` | enum<string> |  `active`, `inactive`, `archived` |
| `nif` | string |  |
| `commercialName` | string |  |
| `position` | string |  |
| `contactNumber` | string |  |
| `emails` | object[] |  |
| `emails.id` | string |  |
| `emails.label` | string |  |
| `emails.email` | string |  |
| `emails.isPrimary` | boolean |  |
| `billingEmail` | string |  |
| `phoneNumbers` | object[] |  |
| `phoneNumbers.id` | string |  |
| `phoneNumbers.label` | string |  |
| `phoneNumbers.number` | string |  |
| `phoneNumbers.countryCode` | string |  |
| `phoneNumbers.isPrimary` | boolean |  |
| `websites` | object[] |  |
| `websites.id` | string |  |
| `websites.label` | string |  |
| `websites.url` | string |  |
| `addresses` | object[] |  |
| `addresses.id` | string |  |
| `addresses.label` | string |  |
| `addresses.addressLine1` | string |  |
| `addresses.addressLine2` | string |  |
| `addresses.city` | string |  |
| `addresses.province` | string |  |
| `addresses.postcode` | string |  |
| `addresses.country` | string |  |
| `addresses.isMain` | boolean |  |
| `folder` | string |  |
| `discountPercentage` | number |  |
| `preferredLanguage` | string |  |
| `currency` | string |  |
| `paymentMethod` | json |  |
| `paymentDays` | string[] |  |
| `expirationDays` | number |  |
| `subscribedToMarketing` | boolean |  |
| `isAppUser` | boolean |  |
| `customFields` | object[] |  |
| `customFields.id` | string |  |
| `customFields.name` | string |  |
| `customFields.value` | json |  |
| `createdAt` | string |  |
| `updatedAt` | string |  |
| `relatedContacts` | object[] |  |
| `relatedContacts.id` | string |  |
| `relatedContacts.name` | string |  |
| `relatedContacts.commercialName` | string |  |
| `relatedContacts.contactType` | enum<string> |  `person`, `company` |
| `relatedContacts.role` | enum<string> |  `client`, `provider`, `lead`, `debtor`, `creditor`, `student`, `teacher`, `unspecified` |
| `relatedContacts.status` | enum<string> |  `active`, `inactive`, `archived` |
| `relatedContacts.relationRole` | string |  |

---

Canonical URL: https://docs.filmo.io/workflows/reference/actions/contacts-find  
Last updated: 2026-10-25