What Are Attachments?
Attachments in OnPage are files added to pages to provide additional context, supporting information, or documentation. These can include images, audio files, and documents, commonly used for medical records, IT log files, and operational reports.
You can upload up to six attachments per page, and once attached, they will remain available as long as the page is retained. Attachments not used within 3 days of upload will be automatically removed.
Using Attachments via the API
Attachments can also be added programmatically when creating pages through the OnPage API. This allows for automated workflows where attachments, such as system-generated reports, log files, or monitoring alerts, can be included in pages without manual uploads.
Example API Use Cases:
- Incident Response – Automatically attach system logs to alert messages.
- Healthcare Automation – Send lab results or imaging reports without manual entry.
- Monitoring Systems – Capture screenshots or error reports from security tools.
How to Use Attachments
Uploading an Attachment (UI)
- Click “Choose a file to upload…” within the message composer.
- Select a supported file type (see below).
- Ensure your file is under 5MB to avoid upload errors.
Attaching to a Page (UI)
- Once uploaded, the file will appear under “Reply Options” with a status of Done.
- The attachment will be included when you send the page.
- If an attachment isn’t sent in a page within 3 days, it will expire.
Adding Attachments via API
- Attachments can be included in automatically generated pages via API calls.
- The API supports multipart file uploads, allowing integrations to add relevant data (logs, reports, screenshots) to dispatched pages.
- Attachments follow the same size limits and retention policies as manually uploaded files.
Allowed File Types and Formats
Images
Used for medical images, screenshots, or documentation.
✅ PNG (.png)
✅ JPEG (.jpg, .jpeg)
Audio
Often used for voice messages or alerts.
✅ AAC (.aac)
✅ WAV (.wav, multiple MIME types)
✅ MP3 (.mp3)
✅ MP4/M4A (.mp4, .m4a)
Documents
Commonly used for reports, logs, or patient records.
✅ Microsoft Word (.doc, .docx)
✅ PDF (.pdf)
Attachment Guidelines
✔ Maximum File Size: 5MB (5,242,880 bytes)
✔ Maximum Attachments per Page: 6
✔ Unused Attachments Expire in: 3 days
✔ Retention: Matches the page’s retention policy
⛔ Unsupported files will be rejected upon upload.
⛔ Attachments over 5MB will not be accepted.
Common Use Cases
🔹 Healthcare – Attach x-rays, lab results, or medical reports for quick reference.
🔹 IT & Security – Upload error logs or diagnostic files to assist troubleshooting.
🔹 Incident Response – Send audio alerts or images related to critical events.
🔹 Automated API Workflows – Attach files to monitoring alerts, security incidents, or scheduled reports automatically.
For any issues with attachments, ensure your file type and size meet the supported criteria.