Aspera

 View Only

 Faspex : How to create SAML users before the user first loggin

Antonin Gouzer's profile image
Antonin Gouzer posted Wed May 13, 2026 08:38 AM

Hello

In faspex 5 we have SAML Authentification activated.

For some projects we have  to add users to workgoups or share inbox before the users first logged in.

If we create the users in advance with their email addresses, users are created without SAML.

When the user finaly loggin he is created in double (email) : one in SAML the previous simple user with the same email.

How can we create  a user and specified that he is a SAML user ?

Or avoid having doublons of emails/users  ?

Thanks in advance

 

Alexander Prado Solis's profile image
Alexander Prado Solis posted Mon May 18, 2026 06:07 PM

Hello Antonin,

In this case you have a few options:

OPTION 1. You can directly create SAML users via API (not possible via UI). Send a POST request to your server https://example.com/aspera/faspex/api/v5/accounts with the following request body in JSON format:

{
"allowed_ip_addresses_for_download": [],
"allowed_ip_addresses_for_login": [],
"allowed_ip_addresses_for_upload": [],
"downloads_allowed": true,
"enforce_password_history": false,
"override_server_sender_quota": false,
"override_server_delete_after_download": false,
"override_transfer_parameters": false,
"received_cc_notification_users": [],
"self_destructs": false,
"sender_quota_limit_mb": "4000",
"uploads_allowed": true,
"user_profile_data_attributes": [],
"name": "exampleuser@example.com",
"welcome_email": true,
"role": "user",
"first_name": "Alex",
"last_name": "Test",
"email": "exampleuser@example.com",
"type": "saml_user",
"saml_configuration_id": 1
}


Notice how the property type is set to "saml_user", also make sure to include the saml_configuration_id property which should match the SAML configuration id associated to this user. Once the user is created you can add them to any Shared Inbox or Workgroup, and once the user logs in via SAML the user will retain those memberships and no duplicate accounts will be created.

OPTION 2. Create specific SAML groups that belong to specific Shared Inboxes/Workgroups. 

For example, create a SAML group called "Faspex Shared Inbox 1"
Then associate for example "Shared Inbox 1" to SAML group "Faspex Shared Inbox 1" (You can do this under Shared Inboxes > Click on your Shared Inbox > Members > SAML groups)
Now anytime a user belonging to SAML group "Faspex Shared Inbox 1" will automatically become a member of "Shared Inbox 1" during login. The same applies for Workgroups.

Related Content