GuidesAPI DocsChangelogMy AppsSeismic Exchange
API Docs

Create a new user

post
https://api.seismic.com/scim/v2/Users

Creates a new user within the Seismic tenant using SCIM 2.0 (System for Cross-domain Identity Management) protocol. Use this endpoint when provisioning users from identity providers or administrative workflows. For example, to create a user, send POST /scim/v2/Users with userName, emails, and schemas containing urn:ietf:params:scim:schemas:core:2.0:User. When the active field is set to false, the newly created user is locked and cannot log in until an administrator activates them. If roles is specified, roles takes precedence and userType is ignored. Custom properties are supported via urn:ietf:params:scim:schemas:extension:seismic:2.0:User; retrieve tenant-specific definitions from GET /scim/v2/Schemas.

Terminology

  • SCIM: System for Cross-domain Identity Management, a standard protocol for managing user identities across systems - GUID: Globally Unique Identifier format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) assigned to the new user - SSO: Single Sign-On, authentication method allowing users to access multiple systems with one login - HTTP: Hypertext Transfer Protocol; validation failures return HTTP 400 with a SCIM error body - JWT: JSON Web Token bearer token required in the Authorization header (seismic.user.manage scope)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

SCIM User resource payload containing required userName, emails, and schema identifiers for user creation.

boolean
Defaults to true

Boolean indicating whether the user account is active and enabled. When set to false, the newly created user is locked and cannot log in until activated by an administrator.

emails
array of objects
required
length ≥ 1

Email addresses for the user. At least one work email is required for user creation in the Seismic tenant.

emails*

Email addresses for the User. The value SHOULD be canonicalized according to RFC 5321. At least one work email is required.

string
enum

A label indicating the attribute's function, specifying the context or purpose of this email address. we only support the type "work" and we only support 1 email.

Allowed:
boolean

A boolean value indicating whether this email address is the primary email for the user. Only one email should be marked as primary.

string

Email address value in standard email format. Must be a valid email address according to RFC 5321 standards.

name
object

The components of the user's full name, including given name and family name, used for display and identification purposes.

schemas
array of strings
required
length ≥ 1

SCIM schema identifiers array indicating which schema extensions apply to this user resource, including core User and optional enterprise or Seismic extensions.

schemas*
Allowed:
string
required
length between 1 and 255

Unique username for the user used for login and authentication. Must be unique across the tenant and is required for user creation.

string
enum

User type classification within the Seismic platform determining access levels and feature availability. Ignored when roles array is specified.

Allowed:
Responses

Updated 5 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/scim+json

Updated 5 days ago