Partner Profiles: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation.

Create a partner profile

When a Wix Partner creates their profile for the first time, your app can handle that flow.

To create a partner profile:

1. Call Create Partner Profile with the partner's initial details. The caller must be authenticated as the partner:

   Copy

2. The response includes the created PartnerProfile with its generated id and revision. Save the id for future updates.

3. The new profile enters the verification queue. Once it passes verification (typically within seconds), a PublicPartnerProfile is published and the partner appears in the public directory.

Keep a partner's profile up to date

If a partner wants to update their own listing — for example, to add a new service, update their portfolio, or change their tagline — your app can manage that flow.

To keep a partner's profile up to date:

1. Call Get Current Partner Profile to retrieve the partner's current PartnerProfile. This requires the partner to be authenticated.

2. Present the returned data in an editing UI so the partner can make changes.

3. Call Update Partner Profile with the modified fields and the latest revision value:

   Copy

4. After a successful update, the changes enter the verification queue. Once verified, a new PublicPartnerProfile is published reflecting the updated data.

Remove a partner from the directory

When a partner wants to permanently remove their listing, your app can delete the profile.

To remove a partner from the directory:

1. Ensure the caller is authenticated as the partner who owns the profile.

2. Call Delete Partner Profile. No body or profile ID is needed, as the profile to delete is determined by the caller's authenticated identity:

   Copy

3. Deletion triggers a PartnerProfile deleted domain event. The corresponding PublicPartnerProfile is removed from the public directory automatically.

Display partners from the public directory

If you want to display an individual partner on a page that anyone can view, your app can retrieve the public profile directly.

To display a partner from the public directory:

1. Call Get Public Partner Profile with the partner's ID to retrieve their full public profile:

   Copy

2. Render the partner detail page using the returned PublicPartnerProfile data, including their professional information, services, portfolio, and platforms.

3. Optionally, if you know the partner's URL slug, call Find Public Partner Profile By Slug instead:

   Copy