Receive roster data via HTTP delivery

If your integration receives data through an API rather than a file server, SchoolDay can deliver export files to your HTTP endpoint instead of uploading them over SFTP. This is a Support-enabled feature.

Requirements

An HTTP endpoint that can accept a multipart form data.
A SchoolDay Support request to enable the feature and register your endpoint URL.

Request HTTP delivery

Contact [email protected] and request HTTP delivery for your export integration.
Provide your endpoint URL and confirm it accepts multipart form data.
Support enables the feature and configures the endpoint URL on the export data source.

After Support enables this feature, you must create the integration to switch the delivery method from SFTP to HTTP. This change will take effect during the next export run; otherwise, the synchronization may not function as expected.

How delivery works

The export file is posted to your endpoint as a multipart form data.
Delivery outcomes are recorded in the export run history available to you.

Verify delivery

Check your endpoint logs for the incoming request on the next scheduled export.
Confirm the file content matches the expected CSV schema for your integration.

Troubleshooting

Symptom	Cause	Fix
No request received at your endpoint	The feature isn't enabled yet, or the endpoint URL on file is incorrect	Confirm with Support that the feature is enabled and the URL is correct
Delivery fails after your endpoint URL changes	The old URL is still on file	Update the registered endpoint URL in the multipart form data
File arrives in an unexpected format	Multipart form parsing issue on your endpoint	Confirm your endpoint reads the file from a multipart form field, not a raw request body

Next steps

Import Roster Data Using SFTP