Skip to main content
POST
Provision a SaaS identity
Key: Write Scope: Company

Authorizations

Authorization
string
header
required

Use your Primo API key in the Authorization header as Bearer <API_KEY>.

Path Parameters

saasId
string
required

Body

application/json
employeeId
string
required

The Primo employee ID to provision on this SaaS application, as returned by the employee endpoints (id field). This is NOT a SaaS identity ID.

groups
string[]

IDs of groups to assign. Retrieve available IDs from getSaasByIdgroups[].id.

Minimum string length: 1
roles
string[]

IDs of roles to assign. Retrieve available IDs from getSaasByIdroles[].id.

Minimum string length: 1
licenses
string[]

IDs of licenses to assign. Retrieve available IDs from getSaasByIdlicenses[].id.

Minimum string length: 1
organizationUnits
string[]

IDs of organization units to assign. Retrieve available IDs from getSaasByIdorganizationUnits[].id.

Minimum string length: 1

Response

default - application/json
provisioningType
enum<string>
required

Whether the provisioning was handled automatically via API or a manual ticket was created.

Available options:
automatic,
manual