OnPage

⌘K
  2. Home
  4. Docs
  6. OnPage
  8. Getting Started
  10. Attachments

Attachments

What Are Attachments?

Attachments in OnPage are files added to messages 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 message, and once attached, they will remain available as long as the page is retained.

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

Web Management Console

  1. Start with the Dispatching tab on nps.onpage.com.
  2. Click “Choose a file to upload…” within the message composer.
  3. Select a supported file type.
  4. Ensure your file is under 5MB.
  5. Once uploaded, the file will appear under “Reply Options” with a status of Done.
  6. All attachments listed as Done will be included with the sent page.

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.
  • If an attachment isn’t added to a message within 3 days, it will expire.

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 message: 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.