Upload attachments to tasks using the ClickUp API. This guide outlines the key requirements for file uploads.

👀

Note

For detailed code examples, refer to the [Create Task docs](🔗).

## Key Requirements

• **Content-Type**: Use `multipart/form-data` in your request header, not `application/json`.

• **File Upload Structure**:

  • Attach files using the `attachment[]` array (e.g., `attachment[0]`, `attachment[1]`).

  • Optional query parameters: `custom_task_ids`, `team_id`.

### Limitations

• The maximum file size is 1 GB.

• No limitations on file types.

## API Endpoint

• **Endpoint**: [Create Task Attachment](🔗)

• **Method**: `POST`

• **Authorization**: Requires a valid API token.

### Error Handling

The API returns a `4xx` error, with the error code `GBUSED_005` when the account storage limit has been exceeded.

## Using Postman?

You can use multipart/form data using Postman by following [these instructions](🔗).