Create New Profile

The Create New Profile endpoint allows you to establish new video player configurations that can be applied to your videos. This endpoint is fundamental for setting up customized player experiences tailored to different audiences, campaigns, or use cases.

Overview

Creating a new profile establishes a baseline configuration that you can later customize with specific settings for player controls, colors, VSL features, save progress functionality, and advanced playback options. Each profile serves as a template that can be applied to multiple videos, ensuring consistent branding and behavior across your content.

What You Need to Provide

When creating a new profile, you need to specify:

Profile Name: This must be the ID of an existing video.
⚠️ Important: The API expects the name field to match the ID of a video already present in the system. If the provided ID does not correspond to an existing video, the profile creation will fail.
Exclusive Flag: Optional boolean indicating whether this profile has special access restrictions

The profile name serves as the primary identifier and should be meaningful within your workflow, but it is strictly required to be an existing video ID.

What You'll Receive

Upon successful creation, the API returns:

Profile ID: A unique UUID that permanently identifies your new profile
Profile Name: Confirmation of the name (video ID) you assigned
Success Message: Confirmation that the profile was created successfully

This response provides the essential information needed to reference and configure your new profile in subsequent operations.

Common Use Cases

Brand Differentiation

When managing content for multiple brands or clients, create separate profiles to ensure each maintains its unique visual identity and user experience.

A/B Testing Setups

Establish multiple profile variations to test different player configurations, helping you optimize viewer engagement and conversion rates.

Environment Management

Create profiles specifically for development, staging, and production environments, enabling safe testing of new configurations before deployment.

Content Type Specialization

Develop profiles optimized for specific content types such as educational materials, promotional videos, or entertainment content, each with appropriate player features enabled.