Attachments

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.