About the Join Applications API

The Join Applications API manages the full workflow for joining an online program, from the initial application or invitation through approval and payment to final enrollment. It supports member-initiated applications, where members request to join a program, and owner-initiated invitations, where Wix users invite specific members to participate.

With the Join Applications API, you can:

• Create and manage applications to join a program.
• Handle both member-initiated applications and owner-initiated invitations.
• Move applications through the approval workflow.
• Process payments for paid programs.
• Apply and manage coupons for program discounts.
• Create program participants automatically on successful completion.
• Manage applications and invitations in bulk.

The API works together with Wix Members, Wix Payments, and Wix Pricing Plans to provide a complete program enrollment solution. A join application supports both one-time payments and subscription-based program access.

Learn more about payment flows and participant creation.

Before you begin

It's important to note the following points before starting to code:

• A program must be published before it accepts applications or invitations.
• A member can have only 1 join application per program.
• Payment methods require the Wix Online Programs app, and paid-plan payments also require the Wix Pricing Plans app.
• Bulk methods are limited to 100 items per request.
• DECLINED and CANCELLED are terminal statuses, and applications in either status are removed asynchronously.
• Members retrieve their own application with Get Current Join Application. Apps tracking an application by ID use Get Join Application, Query Join Applications, or Search Join Applications.

Use cases

• Handle member-initiated program applications
• Manage owner-initiated program invitations
• Process program payments and discounts
• Bulk manage applications and invitations

Terminology

• Join application: The entity tracking a member's path from application or invitation through to enrollment in a program.
• Member flow: Self-service methods that members use to manage their own applications.
• Owner flow: Administrative methods that Wix users call to manage applications on behalf of members.
• Participant: The entity created when a join application completes successfully, representing the member's enrollment in the program.
• Entitlement: A member's existing Pricing Plans subscription that covers a program, letting them skip checkout.

See also

• About Payment Flows
• Sample Flows
• Errors