Skip to main content
Pronote is France’s most widely used school management platform. Papillon provides comprehensive integration with Pronote, giving you access to nearly all features available on the web platform.

​
Overview

The Pronote integration uses the pawnote library to communicate securely with your school’s Pronote instance. It supports dynamic capability detection, meaning Papillon automatically enables features based on what your school has activated.
Pronote capabilities are determined by your school’s configuration. If a feature isn’t available in Papillon, it may not be enabled in your school’s Pronote settings.

​
Supported Features

Papillon’s Pronote integration supports the following capabilities:
  • View homework assignments by week
  • Mark assignments as complete or incomplete
  • Access assignment details and attachments
  • Track deadlines and due dates
Capability: HOMEWORK
  • View grades organized by period
  • Access grade averages and statistics
  • See teacher comments and evaluations
  • Track your academic progress over time
Capability: GRADES
  • View weekly class schedule
  • See room assignments and teacher information
  • Access course resources and materials
  • Receive real-time schedule changes
Capability: TIMETABLE
  • Monitor attendance records by period
  • View absences, delays, and sanctions
  • Track attendance statistics
  • Access absence justifications
Capabilities: ATTENDANCE, ATTENDANCE_PERIODS
  • Read messages from teachers and staff
  • Reply to existing conversations
  • Create new messages to available recipients
  • View message history and threads
Capabilities: CHAT_READ, CHAT_REPLY, CHAT_CREATE
  • View school news and announcements
  • Mark news items as read
  • Access important notices from administration
Capability: NEWS
  • View weekly cafeteria menus
  • See meal details and ingredients
  • Plan your meals in advance
Capability: CANTEEN_MENU

​
Connecting to Pronote

Follow these steps to connect your Pronote account to Papillon:
1

Find Your Instance URL

Your Pronote URL is typically in the format:
https://[school-code].index-education.net/pronote/
You can find this URL:
  • On your school’s website
  • In communication from your school
  • By asking your school administration
Make sure to use the correct URL. Using an incorrect URL will result in connection errors.
2

Choose Account Type

Select your account type:
  • Student - For student accounts
  • Parent - For parent accounts
  • Teacher - For teacher accounts (if supported)
The account type must match your Pronote login credentials.
3

Enter Credentials

Provide your Pronote username and password. These are the same credentials you use to log into Pronote on the web.
Your credentials are stored securely on your device and are never sent to Papillon’s servers.
4

Authentication & Token

Papillon will authenticate with Pronote and receive a secure token. This token is used for all future requests and is automatically refreshed.A unique device UUID is generated to identify your device to Pronote’s servers.
5

Verify Connection

Once connected, Papillon will display your available features based on your school’s Pronote configuration.

​
Authentication Details

Pronote uses a secure token-based authentication system:
  • Initial Login: Papillon authenticates using your username, password, instance URL, and account type
  • Token Generation: A secure access token is generated with a 5-minute validity period
  • Automatic Refresh: Tokens are automatically refreshed before expiration
  • Device UUID: A unique identifier is stored for your device
  • Session Management: Active sessions are maintained throughout your app usage
Authentication Requirements:
- Instance URL (e.g., https://demo.index-education.net/pronote/)
- Account Type (Student, Parent, or Teacher)
- Username
- Token (generated after first login)
- Device UUID (automatically generated)
Pronote sessions have a 5-minute token expiration. Papillon automatically refreshes your session in the background, so you don’t need to log in repeatedly.

​
Dynamic Capabilities

Pronote’s integration uses dynamic capability detection based on your school’s tab permissions:
Pronote TabPapillon Capability
AssignmentsHomework
DiscussionsChat (Read, Reply, Create)
GradesGrades
NotebookAttendance & Attendance Periods
NewsNews
MenusCanteen Menu
TimetableTimetable
If a tab is disabled in your Pronote account, the corresponding feature won’t appear in Papillon.

​
Common Issues

Problem: Authentication fails with invalid credentials.Solutions:
  • Verify your username and password are correct
  • Ensure you selected the correct account type (Student/Parent/Teacher)
  • Check that your Instance URL is accurate
  • Try logging into Pronote’s web interface to confirm your credentials
Problem: Connection times out when trying to sync.Solutions:
  • Check your internet connection
  • Verify the Pronote instance URL is accessible
  • Your school’s Pronote server may be temporarily down
  • Try again after a few minutes
Problem: Some features don’t appear in Papillon.Solutions:
  • These features may not be enabled by your school
  • Check if the features are available on Pronote’s web interface
  • Contact your school administration about enabling features
  • Some features require specific account permissions
Problem: Getting token expiration errors frequently.Solutions:
  • Papillon should automatically refresh tokens
  • Try manually refreshing by pulling down on the home screen
  • If the issue persists, disconnect and reconnect your account

​
Data Sync & Refresh

Pronote data is synchronized with the following behavior:
  • Automatic Token Refresh: Every 5 minutes
  • Manual Refresh: Pull down on any screen to force a refresh
  • Background Sync: Papillon maintains your session while the app is active
  • Session Validation: Automatic token validity checks before each request
If you don’t use Papillon for an extended period, you may need to log in again. This is a security feature to protect your account.

​
Privacy & Security

Papillon’s Pronote integration prioritizes your security:
  • ✓ Credentials stored locally using secure device storage
  • ✓ Token-based authentication (no password stored after initial login)
  • ✓ HTTPS encryption for all communication
  • ✓ Automatic session cleanup on logout
  • ✓ Device-specific UUID for added security
  • ✓ No data shared with third-party servers

​
Technical Implementation

The Pronote integration is built using:
  • Library: pawnote - A TypeScript library for Pronote API communication
  • Authentication: Token-based with automatic refresh
  • Session Management: SessionHandle maintains connection state
  • Capability Detection: Dynamic feature enabling based on user permissions
Implementation reference: /services/pronote/index.ts

​
Supported Use Cases

Students

  • Track homework and assignments
  • Monitor grades and progress
  • View class schedule
  • Communicate with teachers

Parents

  • Monitor child’s academic performance
  • View attendance records
  • Track homework completion
  • Communicate with teachers and staff

​
Next Steps

Explore Features

Learn about all available features in Papillon

Other Integrations

Check out other supported platforms

Build docs developers (and LLMs) love

Get started for freeTalk to us