---
title: "/attachments"
method: POST
path: "/c/{company_id}/attachments"
---

# /attachments

`POST /c/{company_id}/attachments`

## Request

- Base URL: `https://api.recruitee.com`
- URL: `https://api.recruitee.com/c/{company_id}/attachments`
- Auth: OAuth 2

Allows to upload files to: offer or candidate.

## Path parameters

- `company_id` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `attachment` object
    - `remote_file_url` string, required: Link to file saved on some external website. You can use attachment[file] instead if you want to upload a file - see examples.
    - `candidate_id` string: If you add candidate ID, the file will show in candidate profile
    - `offer_id` string: If you add offer ID, the file will show in offer file tab

## Response `201`

201

- object
  - `attachment` object
    - `admin_id` integer
    - `candidate_id` integer
    - `created_at` string
    - `extension` string
    - `file_size` integer
    - `file_url` string
    - `filename` string
    - `guest_id` unknown
    - `id` integer
    - `kind` string
    - `offer_id` unknown
    - `pdf_thumbnail_url` string
    - `pdf_url` string
    - `status` string
    - `uploader` string
    - `visibility` object
      - `admin_ids` unknown[]
        - unknown
      - `level` string
      - `role_ids` unknown[]
        - unknown
  - `references` object[]
    - `admin_id` integer
    - `adminapp_url` string
    - `created_at` string
    - `emails` unknown[]
      - unknown
    - `example` boolean
    - `id` integer
    - `last_message_at` unknown
    - `name` string
    - `notes_count` integer
    - `pending_result_request` boolean
    - `phones` unknown[]
      - unknown
    - `photo_thumb_url` string
    - `positive_ratings` unknown
    - `rating` integer
    - `ratings` object
    - `ratings_count` integer
    - `referrer` unknown
    - `source` string
    - `tasks_count` integer
    - `type` string
    - `upcoming_event` boolean
    - `updated_at` string
    - `viewed` boolean

## Other responses

- `401`: 401
- `422`: 422

---

[API](https://skmtc.dev/recruitee/apis/ats-api.md) - [All operations](https://skmtc.dev/recruitee/apis/ats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitee/apis/ats-api/revisions/92a80d21a7e0?raw)