---
title: "Attach a file to a lead"
method: POST
path: "/lead/{id}/files/"
tags: ["leads"]
---

# Attach a file to a lead

`POST /lead/{id}/files/`

Attach an already-uploaded file to a lead. First upload the file to S3 using the [Files API](https://developer.close.com/api/resources/files), then pass the resulting download `url` here along with its `filename` and `content_type`.

## Path parameters

- `id` string, required

## Request body

- CreateLeadFile
  - `content_type` string, required
  - `filename` string, required
  - `url` string, required

## Response `201`

Successful response

- LeadFile
  - `checksum` string, required
  - `content_type` string, required
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `download_url` string, required
  - `id` string, required
  - `is_pinned` boolean, required
  - `last_activity_at` string, date-time, required
  - `last_object_id` string, required
  - `last_object_type` string, required
  - `lead_id` string, required
  - `name` string, required
  - `organization_id` string, required
  - `size` integer, required
  - `thumbnail_url` string, nullable, required
  - `updated_by` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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