Users and roles

Every Medipim user has a role that determines what they can see and do through the API. Your role is typically assigned by Medipim when your account is created. Resellers can also create users on behalf of their clients (see Reseller below).

Available roles

Role	API value	Description
Organization manager	organization_manager	Can manage products, descriptions, media, and users for their organization.
Software developer	software_developer	Read-only access to all products and published media across the platform.
Medical professional	medical_professional	Read-only access to all products and published media across the platform.
Reseller	reseller	Can manage organizations and users on behalf of their clients.

The API value column shows the string you pass in the role field when filtering users.

Organization manager

The organization manager is the most capable role available for managing product content. Organization managers can:

• Query and view all non-deleted products that belong to their organization.
• Update product fields for their organization's products.
• Create, update, and delete product descriptions.
• Upload images (JPEG, PNG) and PDFs.
• Publish and unpublish media items owned by their organization.
• Link media items to products.
• Export products (up to 10 000 records), media, and descriptions.
• Update user profiles and preferences within their organization.

All write operations are scoped to the organization — an organization manager cannot modify products or media belonging to another organization.

Software developer

The software developer role is designed for technical integrators who need to read product data from across the entire platform (not limited to a single organization). Software developers can:

• Query and view all non-deleted products across the platform.
• Query and view published, non-deleted media items.
• Query product descriptions matching their target groups.
• Export products (up to 100 records).
• Query brands, categories, product families, and active ingredients.

Software developers cannot create, update, or delete any data. They also cannot view unpublished media or access media upload/publish endpoints.

Medical professional

The medical professional role has the same permissions as the software developer role. It exists as a distinct role to identify the user's profession, which may affect which target groups and content they have access to through their subscription.

Reseller

The reseller role is intended for partners that distribute Medipim access to their own clients. Resellers can:

• Create organizations and link them to their reseller account.
• Create users via the create user endpoint — but only with the medical_professional role.
• Create and manage API keys for users linked to their reseller account.
• Update user profiles, preferences, and subscriptions for their linked users.
• Query and view organizations and users linked to their reseller account.

Resellers do not have access to product, media, or description data.

Choosing a role

When building an integration, the right role depends on your use case:

• Synchronizing product data to an external system — use software_developer or medical_professional. These roles provide read access to all products without requiring an organization relationship.
• Managing your organization's product content — use organization_manager. This gives you write access to your organization's products, descriptions, and media.
• Distributing Medipim access to clients — use reseller. This lets you create organizations, users, and API keys for your clients.