*Workflows › Reference › Actions › Contacts*

# Relate two contacts

> Creates a directed relationship from one contact to another, with its role.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `contacts` |
| Group in the editor | Contacts › Contacts |
| Runs as | The owner of the workflow, with their permissions |
| Permission | Edit 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_related_add`) |

ACTION `contacts.addRelatedContact`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `contactId` | string | Yes |  |
| `relatedContactId` | string | Yes |  |
| `relationRole` | string | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `contactId` | string |  |
| `relatedContactId` | string |  |
| `relationRole` | string |  |

---

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