--- title: "Link entity to contact" method: POST path: "/entities/{id}/link_contact" tags: ["Entities"] --- # Link entity to contact `POST /entities/{id}/link_contact` Link a specified contact to an entity by their IDs. ## Path parameters - `id` integer, required ## Query parameters - `contact_id` integer, required ## Response `200` Entity linked with contact successfully - object - `data` EntityExtended - `id` integer - `client_id_number` string - `name` string - `entity_type` string - `metadata` object — Additional metadata for the entity, contents may vary - `ein` string — Employer Identification Number (EIN) - `other_ids` object — Other identifying information, contents may vary - `created_at` string, date-time - `updated_at` string, date-time - `primary_contact` object — Primary contact for this entity - `contacts` ContactExtended[] — List of contacts associated with this entity - `id` integer - `first_name` string - `last_name` string - `nick_name` string - `company` string - `job_title` string - `client_id_number` string - `tags` Tag[] - `id` integer - `name` string - `contact_emails` ContactEmail[] - `id` integer - `email` string - `primary` boolean - `created_at` string, date-time - `updated_at` string, date-time - `contact_phones` ContactPhone[] - `id` integer - `phone_number` string - `country_code` string - `country_phone_code` string - `phone_type` 'mobile' | 'home' | 'work' | 'fax' | 'office' | 'other' - `primary` boolean - `metadata` object - `created_at` string, date-time - `updated_at` string, date-time - `contact_addresses` ContactAddress[] - `id` integer - `street_address` string - `city` string - `state` string - `zip` string - `primary` boolean - `created_at` string, date-time - `updated_at` string, date-time - `entity_origins` Entity[] - `id` integer - `client_id_number` string - `name` string - `entity_type` string - `metadata` object - `ein` string - `other_ids` object - `created_at` string, date-time - `updated_at` string, date-time - `primary_contact` Contact - `contact` object - `first_name` string - `last_name` string - `tag_list` string[] - `created_at` string, date-time - `updated_at` string, date-time - `contact_emails_attributes` object[] - … - `contact_phones_attributes` object[] - … - `contacts` Contact[] - `contact` object - `first_name` string - `last_name` string - `tag_list` string[] - `created_at` string, date-time - `updated_at` string, date-time - `contact_emails_attributes` object[] - … - `contact_phones_attributes` object[] - … - `projects` Project[] - `id` integer - `name` string - `idempotency_key` string - `metadata` object - `due_date` string, date-time - `assignees` Assignee[] - `id` integer - `email` string - `user` User - `id` integer - `email` string - `tags` Tag[] - `id` integer - `name` string - `tasks` Task[] - `id` integer - `name` string — Name of the task - `description` string — Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>. - `status` 'to_do' | 'pending_review' | 'approved' — Status of the task - `project_status` ProjectStatus - `id` integer - `name` string - `position` integer - `projects` ProjectExtended[] — List of projects associated with this entity - `id` integer - `name` string - `tax_year` string - `idempotency_key` string - `metadata` object - `due_date` string, date-time - `assignees` Assignee[] - `id` integer - `email` string - `tasks` Task[] - `id` integer - `name` string — Name of the task - `description` string — Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>. - `status` 'to_do' | 'pending_review' | 'approved' — Status of the task - `user` User - `id` integer - `email` string - `tags` Tag[] - `id` integer - `name` string - `entity` Entity - `id` integer - `client_id_number` string - `name` string - `entity_type` string - `metadata` object - `ein` string - `other_ids` object - `created_at` string, date-time - `updated_at` string, date-time - `primary_contact` Contact - `contact` object - `first_name` string - `last_name` string - `tag_list` string[] - `created_at` string, date-time - `updated_at` string, date-time - `contact_emails_attributes` object[] - … - `contact_phones_attributes` object[] - … - `contacts` Contact[] - `contact` object - `first_name` string - `last_name` string - `tag_list` string[] - `created_at` string, date-time - `updated_at` string, date-time - `contact_emails_attributes` object[] - … - `contact_phones_attributes` object[] - … - `projects` Project[] - `id` integer - `name` string - `idempotency_key` string - `metadata` object - `due_date` string, date-time - `assignees` Assignee[] - `id` integer - `email` string - `user` User - `id` integer - `email` string - `tags` Tag[] - `id` integer - `name` string - `tasks` Task[] - `id` integer - `name` string — Name of the task - `description` string — Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>. - `status` 'to_do' | 'pending_review' | 'approved' — Status of the task - `project_status` ProjectStatus - `id` integer - `name` string - `position` integer ## Other responses - `404` — Entity or Contact not found --- [API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/9418bb2b65bf/schema)