> ## Documentation Index
> Fetch the complete documentation index at: https://timelines.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# File Attachments

> Send images, documents, and other files via WhatsApp

# File Attachments

Send images, documents, audio, and other files as WhatsApp messages.

## Workflow

Sending a file is a two-step process:

**1. Upload the file**

Upload to TimelinesAI and get a `file_uid`

**2. Send with the file\_uid**

Include `file_uid` when sending your message

## Uploading files

### Option 1: Upload from URL

If your file is publicly accessible:

```bash theme={null}
curl -X POST "https://app.timelines.ai/integrations/api/files" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/brochure.pdf",
    "filename": "product-brochure.pdf"
  }'
```

Response:

```json theme={null}
{
  "status": "ok",
  "data": {
    "uid": "90d353e6-44c1-48ff-b15b-69b7721e5450",
    "filename": "product-brochure.pdf",
    "mime_type": "application/pdf",
    "size": 245678
  }
}
```

### Option 2: Upload file directly

For local files, use multipart form data:

```bash theme={null}
curl -X POST "https://app.timelines.ai/integrations/api/files_upload" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/document.pdf" \
  -F "filename=document.pdf"
```

## Sending files

Once uploaded, use the `file_uid` to send:

### File with text

```bash theme={null}
curl -X POST "https://app.timelines.ai/integrations/api/messages" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+14155551234",
    "text": "Here is the document you requested!",
    "file_uid": "90d353e6-44c1-48ff-b15b-69b7721e5450"
  }'
```

## Supported file types

| Category | Formats | Max Size |
| - | - | - |
| Images | JPG, PNG, GIF, WebP | 16 MB |
| Documents | PDF, DOC, DOCX, XLS, XLSX | 100 MB |
| Audio | MP3, OGG, OGA, AAC | 16 MB |
| Video | MP4, 3GP | 16 MB |

## Managing uploaded files

### List files

```bash theme={null}
curl -X GET "https://app.timelines.ai/integrations/api/files" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

### Get file details

```bash theme={null}
curl -X GET "https://app.timelines.ai/integrations/api/files/90d353e6-44c1-48ff-b15b-69b7721e5450" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

### Delete file

```bash theme={null}
curl -X DELETE "https://app.timelines.ai/integrations/api/files/90d353e6-44c1-48ff-b15b-69b7721e5450" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Next steps

> [card] [Send messages](https://timelines.ai/docs/guides/sending-messages.md)
>
> More messaging options

> [card] [Webhooks](https://timelines.ai/docs/guides/webhooks.md)
>
> Get notified of incoming files


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.