---
title: "Create Attachments"
method: POST
path: "/ats/attachments"
tags: ["ats/attachments"]
---

# Create Attachments

`POST /ats/attachments`

Create Attachments in any supported ATS software

## Query parameters

- `remote_data` boolean

## Headers

- `x-connection-token` string, required

## Request body

- UnifiedAtsAttachmentInput
  - `file_url` string, nullable — The URL of the file
  - `file_name` string, nullable — The name of the file
  - `attachment_type` 'RESUME' | 'COVER_LETTER' | 'OFFER_LETTER' | 'OTHER', nullable — The type of the file
  - `remote_created_at` string, date-time, nullable — The remote creation date of the attachment
  - `remote_modified_at` string, date-time, nullable — The remote modification date of the attachment
  - `candidate_id` string, nullable — The UUID of the candidate
  - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora

## Response `201`

- UnifiedAtsAttachmentOutput
  - `file_url` string, nullable — The URL of the file
  - `file_name` string, nullable — The name of the file
  - `attachment_type` 'RESUME' | 'COVER_LETTER' | 'OFFER_LETTER' | 'OTHER', nullable — The type of the file
  - `remote_created_at` string, date-time, nullable — The remote creation date of the attachment
  - `remote_modified_at` string, date-time, nullable — The remote modification date of the attachment
  - `candidate_id` string, nullable — The UUID of the candidate
  - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora
  - `id` string, nullable — The UUID of the attachment
  - `remote_id` string, nullable — The remote ID of the attachment
  - `remote_data` object, nullable — The remote data of the attachment in the context of the 3rd Party
  - `created_at` string, date-time, nullable — The created date of the object
  - `modified_at` string, date-time, nullable — The modified date of the object

## Changes

- **2024-08-05** `ca0fa45ebd05` — 1 breaking, 4 warning, 4 info
  - request property `attachment_type` was restricted to a list of enum values
  - added the new `COVER_LETTER` enum value to the `attachment_type` response property for the response status `201`
  - added the new `OFFER_LETTER` enum value to the `attachment_type` response property for the response status `201`
  - added the new `OTHER` enum value to the `attachment_type` response property for the response status `201`
  - …5 more
- **2024-08-05** `ca213ae36b7f` — 18 breaking, 9 info
  - the response property `attachment_type` became nullable for the status `201`
  - the response property `candidate_id` became nullable for the status `201`
  - the response property `created_at` became nullable for the status `201`
  - the response property `field_mappings` became nullable for the status `201`
  - …23 more
- **2024-08-05** `167edd5346ec` — 10 breaking, 5 info
  - the request property `attachment_type` became not nullable
  - the request property `candidate_id` became not nullable
  - the request property `field_mappings` became not nullable
  - the request property `file_name` became not nullable
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/panoratech/apis/panora-api-2/changes/ats/attachments/post.md)

---

[API](https://skmtc.dev/panoratech/apis/panora-api-2.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panoratech/panora-api-2/revisions/ca0fa45ebd05/schema)