The Partner Profiles API lets Wix Partners manage their public profile and lets external developers read it. A partner profile is how agencies and freelancers showcase their work across Wix surfaces: the Partner Directory, the Wix Marketplace, and the Templates Marketplace.
A Wix Partner is an agency or freelancer that uses a partner profile to showcase their work. A partner profile may be linked to one or more surfaces depending on the partner's status: the Partner Directory (a registry of all partner profiles), the Wix Marketplace (for partners who have been accepted to it), or the Templates Marketplace (for partners who have created a template listing). Each partner account has exactly one profile. The profile represents the agency or freelancer, not an individual team member.
The API has two distinct layers:
PartnerProfiles service (owner-facing): The partner's editable working copy. Partners use it to update professional information, services, portfolio items, and contact details. Access is authenticated and restricted to the profile owner.PublicPartnerProfiles service (public-facing): The verified, published projection that appears on partner directory pages. A new PublicPartnerProfile is created or updated only after the partner's edits pass verification. All reads are unauthenticated: no Wix account is required.With the Partner Profiles API, you can:
Every time a partner creates or updates their profile, the content enters an automated verification queue. During verification, the profile's validation.validationStatus is set to PENDING_VALIDATION. Once verification completes (typically within seconds), the status changes to either:
VALID: The content passed verification. A PublicPartnerProfile is created or updated to reflect the latest changes.NOT_VALID: The content failed verification. The validation.failedValidationReasons field lists the specific fields and failure categories. To resolve, call Update Partner Profile with corrected content. This resets the status to PENDING_VALIDATION and triggers re-verification.The following fields are subject to content verification: professionalInformation.about, professionalInformation.tagline, and professionalInformation.businessWebsite (the URL content is fetched and scanned).
It's important to note the following points before starting to code:
PartnerProfile (editable) and PublicPartnerProfile (published) entities are separate. Updates to PartnerProfile don't immediately appear in PublicPartnerProfile. Changes go through a verification step first.PublicPartnerProfiles read methods require no permission or authentication.PartnerProfile per Wix account (agency). Multiple team members on the same account share a single profile.ContactPartner method is reserved for Wix first-party UI use and isn't intended for third-party integrations.slug is auto-generated from their professionalInformation.businessName at profile creation. It can be changed via the API.euValid field is set automatically by the system based on the partner's country and EU trader traceability status. Partners can't set this field directly. When true, you can display an EU compliance indicator on the partner's profile.hideFromDirectory to true opts the partner out of appearing in the Partner Directory listing, but the public partner profile remains accessible via the API regardless of this setting.PartnerProfile. Only verified updates are reflected in the PublicPartnerProfile.