Overview

The Attachments API enables you to securely upload files to Connecteam's cloud storage for use with other platform features like Chat, Scheduler, Users, and Quick Tasks.

How It Works

File uploads follow a three-step process:

1. Generate Upload URL - Get a pre-signed URL for secure uploading
2. Upload File - Upload directly to cloud storage using the pre-signed URL
3. Complete Upload - Finalize the upload to register the file

⚠️

Time Limit

The pre-signed upload URL expires after 300 seconds (5 minutes). You must complete the upload within this time or generate a new URL.

---

Available Endpoints

---

Feature Types

When generating an upload URL, you must specify which feature the attachment is for:

---

Constraints

🚨

File Size Limit

Files larger than 1 GB will be rejected during the complete-upload step and automatically deleted from storage.

---

Authentication

All endpoints require authentication via API key or OAuth 2.0.

Required Scopes

---

What Can You Achieve?

With the Attachments API, you can:

• Securely upload files to the cloud for use with Connecteam's various API features
• Automate file uploads and data retrieval, reducing manual input and errors
• Attach files to chat messages, user profiles, tasks, and scheduler notes

Important Considerations

• Data Security: Ensure file transfers comply with your organization's security policies
• API Limits: Be aware of rate limits when planning file operations
• Testing: Always test uploads in a development environment first

📝

Note

Files uploaded via this API are for use with Connecteam features only, not for general storage purposes.

---

Guide Pages

---

API Reference