---
title: "Create Company Interaction"
method: POST
path: "/api/companies/{company_uuid}/interactions"
tags: ["company-interactions"]
---

# Create Company Interaction

`POST /api/companies/{company_uuid}/interactions`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/interactions`
- Auth: HTTP bearer

Create a new company interaction.

The interaction can include file attachments that were previously uploaded using the /api/files/upload endpoint.
For each attachment, provide:
- storage_filename: The storage filename returned by the upload endpoint
- original_name: The original filename of the uploaded file
- content_type: The content type of the file

The files will be moved from the upload folder to the interaction's permanent storage location.

## Path parameters

- `company_uuid` string, uuid, required

## Headers

- `X-Teamspace-Uuid` string, uuid, nullable
- `X-User-Email` string, nullable
- `X-User-Name` string, nullable

## Request body

- CompanyInteractionCreate: Schema for creating a company interaction. Participants are optional. They can be registered (organizations with contacts), unregistered (other_participants), or omitted entirely.
  - `title` string, required
  - `description` string, nullable
  - `interacted_at` string, date-time, required
  - `medium` string, required
  - `sentiment` string, nullable
  - `sentiment_numeric` integer, nullable
  - `status` 'draft' | 'published'
  - `other_participants` object[], nullable
  - `email_body` string, nullable
  - `source` 'app' | 'email'
  - `user_uuids` string[]
  - `organizations` CompanyInteractionOrganizationContact[]
    - `organization_uuid` string, uuid4, required
    - `experiences` InteractionExperienceRef[], required
      - `experience_uuid` string, uuid4, nullable
      - `contact_uuid` string, uuid4, nullable
  - `attachments` object[], nullable
  - `info` object, nullable
  - `visibility` 'company' | 'personal'

## Response `201`

Successful Response

- CompanyInteraction: Schema for complete company interaction response
  - `title` string, required
  - `description` string, nullable
  - `interacted_at` string, date-time, required
  - `medium` string, required
  - `sentiment` string, nullable
  - `sentiment_numeric` integer, nullable
  - `status` 'draft' | 'published'
  - `other_participants` object[], nullable
  - `email_body` string, nullable
  - `source` 'app' | 'email'
  - `uuid` string, uuid4, required
  - `company_uuid` string, uuid4, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `users` UserBase[], required
    - `uuid` string, uuid4, required
    - `name` string, required
    - `phone_number` string, nullable
    - `email` string, email, required
    - `avatar_file_name` string, nullable
    - `ui_language` 'en' | 'pt' | 'es', nullable
    - `avatar_url` string, nullable, required: Get the avatar URL based on the filename if one exists
  - `organizations` AppViewsSchemasCompanyInteractionSchemaOrganizationMTM[], required
    - `uuid` string, uuid4, required
    - `name` string, required
    - `type` string, required
    - `short_name` string, nullable
    - `country` AppViewsSchemasCompanyInteractionSchemaCountryMTM, required: Schema for country in MTM relationships
      - `id` integer, required
      - `code` string, required
      - `name` string, required
      - `description` string, nullable
    - `contacts` AppViewsSchemasCompanyInteractionSchemaContactMTM[], required
      - `uuid` string, uuid4, required
      - `name` string, required
      - `experience_uuid` string, uuid4, nullable
      - `role` string
      - `experience_type` string, nullable
      - `start_date` string, nullable
      - `end_date` string, nullable
      - `label` string, nullable
  - `attachments` object[], nullable, required
  - `info` object, nullable
  - `collections` string[]
  - `groups` InteractionGroupSummary[]
    - `uuid` string, uuid4, required
    - `name` string, required
  - `visibility` string
  - `personal_owner_user_uuid` string, uuid4, nullable
  - `access_denied` boolean
  - `my_access_level` string, nullable
  - `attachments_with_urls` object[], nullable, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)