How to Send Student Activity Data in CSV to Woolf

Colleges can report verified academic activity by submitting structured CSV files to Woolf. These files are used to record student submissions, grades, feedback, meeting participation, and general learning activity. This guide outlines the correct formats for each type of data, with downloadable templates to help you get started.

⚠️ Important Notes:

Submissions using CSVs are not related to the primary workflow and should only be used in exceptional cases. It is not a valid alternative for standard activity syncing.
Sometimes there is evidence not captured by Woolf’s SDK. In such cases, Woolf may evaluate it for inclusion in a student’s academic record (back accreditation since it is not real-time).
Woolf does not guarantee accreditation of CSV learning. We will evaluate and say how much can potentially be included in the accreditation record.
All CSV imports require a valid SOW contract.
CSV imports must be completed within 60 days of kickoff. After 60 days, accreditation by CSV is not allowed (partial enrollments are required).
Back accreditation by CSV can only be applied to a maximum of 50% of a student’s degree progress.
Woolf only supports CSV imports for three activity types: assignment submissions (regular assignments only, not summative), grades, and meeting attendance (only if there is a recording).
For assignment submissions, the Woolf can only accept evidence containing either the actual submission content (HTML/Markdown) or meaningful files that can be stored on the AMS.
Meeting attendance requires evidence. A recording must be attached to the resource (via Airlock API or CSV import). Do not include unrecorded meetings.
Before submitting, ensure that all students and resources referenced in the CSV exist in Woolf. The resource_id and student_id must match Woolf’s system to allow successful processing.
Submit one file per activity type via Slack or email. Do not combine different activity types in a single CSV.

How to Send CSV Data to Woolf

Create resources in Woolf. The resource_id generated will be used in the CSV. (API Docs)
Add students as StudyTrack students in Woolf. The student_id generated will be used in the CSV. (API Docs)
Send CSV files via Slack or email. Each CSV should only contain one activity type.

📄 CSV Format for Student Submissions

Use this format to report assignment submissions. Include either written content or a file URL. Submissions must contain text/HTML/Markdown, or if a file-based submission, please notify Woolf in advance.

resource_id
student_id
submission_text
submission_content (alias for text/HTML/Markdown)
submission_url
assets (optional file attachments: PDF, video, audio)
timestamp

Download Student Submissions Template

📄 CSV Format for Grades

Use this format to record final or interim grades assigned to student work. Make sure grades are only submitted for resources where a submission exists, to avoid inconsistencies (grades without matching submissions).

resource_id
student_id
grade (0–100)
timestamp
teacher_id (optional)

Download Grades Template

📄 CSV Format for Feedback

Use this format to provide instructor feedback on student submissions. Note: Feedback is not part of back accreditation imports, but may be logged for reference.

resource_id
student_id
feedback_content
feedback_url
timestamp
teacher_id (optional)

Download Feedback Template

📄 CSV Format for Meeting Attendances

Use this format to record student attendance in scheduled meetings or live sessions. Only include meetings where a recording exists, as evidence must be provided and linked to the resource (e.g., via Airlock API).

resource_id
student_id
timestamp

Download Meeting Attendance Template

📄 CSV Format for Meeting Recordings

Use this format to submit URLs to meeting recordings for auditing or archival purposes. Note: Recording submissions are supportive evidence but not counted as part of back accreditation.

resource_id
recording_url

Download Meeting Recording Template

📄 CSV Format for General Resource Consumption

Use this format to log access to course materials, such as reading a document or watching a video. Note: These logs are not part of CSV back accreditation and are for tracking only.

resource_id
student_id
timestamp

Download Resource Consumption Template

Column Reference

Field	Description	Example Value
`student_id`	Woolf or external ID for the student.	b2cb33d6-c114-4c0f-ba38-5c4fdd4e33d0
`resource_id`	Woolf or external ID for the learning resource.	04c9a70e-1cc2-4838-bc5d-a8af535672fc
`teacher_id`	Woolf or external ID for the teacher.	62e65a81-9820-40f5-ae22-a4eaa57c8486
`grade`	Score between 0–100. Should be linked to a submission.	100
`submission_text`	Text/HTML/Markdown content. Leave blank if using `submission_url`.	`<html> <body><h1>My Bubble Sort Implementation</h1></body> </html>`
`submission_url`	Publicly accessible file links. Must remain live for at least 7 days.	https://cdn.example/assignment.pdf
`recording_url`	Same rules as `submission_url`.	https://cdn.example/recording.mp4
`feedback_content`	Text/HTML/Markdown feedback. Optional if `feedback_url` is provided.	Well-structured essay with strong arguments.
`timestamp`	Date and time in ISO 8601 format.	2023-11-30T12:45:00Z
`assets`	Attach files (PDFs, videos, audios) via URL. Woolf will fetch the file from the provided link.	https://cdn.example/evidence.pdf