AcademIA Enrollment
AcademIA Enrollment gets people into your AcademIA courses. With a single component you work with two things: invitations to a learning path (a course) and enrollments in a program edition, for example a master’s degree or an academic year.
It is useful when sign-ups come in through other channels, such as a web form, a spreadsheet, your CRM or an AI agent, and you want them in AcademIA without doing it by hand.
When to use it
- Everyone who signs up on your website’s form must be enrolled in the program.
- When a sale closes in your CRM, you want to invite the customer to the welcome path.
- You have a list of hundreds of emails and want to invite them to a path in one go.
- You want to suspend, drop or reactivate a learner in a program.
- You need a list of who still has a pending invitation, to follow them up.
Configuration
You need an AcademIA credential with two details: AcademIA API address, the AcademIA API address (for example https://academia.nappai.es/api), and API key, an AcademIA API key (it starts with nappai_int_sk_live_). NappAI doesn’t ask for the email or password of any AcademIA account. See Credentials.
An AcademIA administrator creates the key with New key:
- A Super admin, in Platform › API keys. In Acts as, choose the role the key works with (and its organisation or faculty, if the role needs one). For the voice evaluator and the course mentor, also tick Voice and mentor sessions.
- A Corporate admin, in Advanced › API keys. That key acts as their company’s administrator and only sees their organisation.
AcademIA shows the key only once: copy it when you create it and paste it into API key. If someone revokes it in AcademIA, the flow stops getting in straight away and you need to create another one.
For this component, the key must act as Content admin (CONTENT_ADMIN), Faculty admin (FACULTY_ADMIN) or Super admin (SUPER_ADMIN).
| Field | What it does |
|---|---|
| Credential (required) | The AcademIA credential. It fills in AcademIA API address and AcademIA API key for you. |
| Resource | What you work with: Path Invitations (invitations to a path) or Program Enrollments (enrollments in a program). Default: Path Invitations. |
| Operation | What you do. The list changes with the chosen Resource. See Resources and operations. |
When you choose the resource and the operation, the component shows only the fields that operation needs.
Resources and operations
Path Invitations (invitations to a learning path)
| Operation | What it does | Fields |
|---|---|---|
List Path Invitations | Returns a path’s invitations, with their status, the invited person and who invited them. | Path ID. Optional: Status (Any, PENDING, ACCEPTED, EXPIRED or REVOKED), Page and Per page. |
Invite to Path | Invites one or several people to a path by email. | Path ID, Emails. Optional: Message and Expires at. |
Revoke Path Invitation | Cancels a pending invitation. | Invitation ID |
Resend Path Invitation | Notifies a pending invitation again. | Invitation ID |
- Emails takes one email or several separated by commas or lines, up to 500 per run.
- Message is a note that goes with the invitation, up to 500 characters.
- Expires at is the date the invitation expires, for example
2026-12-31or2026-12-31T23:59:00Z. - Invitation ID comes from
List Path Invitations. Only pending invitations can be revoked or resent.
If the invited person already has an AcademIA account and the path has automatic enrollment, they are enrolled right away. If they don’t have an account yet, the invitation waits for them until they register.
Program Enrollments (enrollments in a program edition)
| Operation | What it does | Fields |
|---|---|---|
List Program Enrollments | Returns the learners enrolled in an edition, with their status and progress. | Edition ID. Optional: Status (Any, ACTIVE, COMPLETED, DROPPED or SUSPENDED), Academic year, Page and Per page. |
Enroll in Program | Enrolls a learner in an edition, by their email or their AcademIA ID. | Edition ID and Student email or Student ID. Full name if the person doesn’t have an account yet. Optional: Academic year and Path IDs. |
Update Program Enrollment | Changes the status of an enrollment. | Enrollment ID, New status |
- If the email in
Enroll in Programhas no AcademIA account, one is created with the given Full name and AcademIA sends them an activation email. - Academic year is written as
2026-2027. Path IDs are the program’s paths to enroll in, separated by commas. - New status can be
ACTIVE(reactivates the enrollment),SUSPENDED(pauses it) orDROPPED(marks it as left). - Page and Per page are in the advanced settings: by default page 1 is returned with 20 results, and at most 100 per page.
Output
The Data output returns AcademIA’s answer as data: one item per invitation or enrollment for the operations that list, and the item created or changed for the others. This way the next component can read each value directly, such as the email or the status.
The component supports Batch Mode, to enroll or invite each person in a list, and it can be connected to an Agent as a tool. See Tools.
Example
A business school receives sign-ups for its master’s degree through a web form.
- The form reaches the flow through a Webhook Input with the person’s name and email.
- Add AcademIA Enrollment with the
Program Enrollmentsresource and theEnroll in Programoperation. - In Edition ID enter this year’s edition ID, in Student email the email from the form and in Full name their name, in case they don’t have an account yet.
- Connect Data to an email component that tells the registrar’s office about the new enrollment.
Good practices
- IDs are AcademIA’s own: you get a path’s ID with AcademIA Content,
List Pathsoperation; you see an edition’s ID in the program, inside AcademIA. Don’t type made-up values. - As an agent tool, fix Path ID or Edition ID yourself in the component and let the agent fill in the emails, names and message.
- If AcademIA answers with a 500 error, the most common cause is an ID that doesn’t exist or a value that isn’t valid. Check what you sent.
Security and limitations
- AcademIA doesn’t send any email with path invitations. Let people know yourself, for example with an email component after
Invite to Path. Resend Path Invitationonly notifies again, inside the app, people who already have an account. It doesn’t send an email either.DROPPEDdoesn’t remove access to the paths the learner had already started.- If you pass more than 500 emails in Emails, only the first 500 are invited. For longer lists, use Batch Mode or split the list.
- The AcademIA address and API key are kept in the credential; don’t type them in the component.
Related components
- AcademIA Organization: a company’s members, their seats and their assigned paths.
- AcademIA Content: create, publish and translate paths.
- AcademIA Webhook: starts the flow with what happens in AcademIA.