GuidesAPI DocsChangelogMy AppsSeismic Exchange
API Docs

Create a new group

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

Creates a new group within the Seismic tenant using SCIM 2.0 (System for Cross-domain Identity Management) protocol. Use this endpoint when provisioning groups from identity providers or administrative workflows. For example, to create a "Sales Team" group, send a POST request with displayName set to "Sales Team" and schemas containing urn:ietf:params:scim:schemas:core:2.0:Group. The response returns the complete group resource with its assigned GUID (Globally Unique Identifier).

Terminology

  • SCIM: System for Cross-domain Identity Management, a standard protocol for managing identities across systems - GUID: Globally Unique Identifier format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) assigned to the new group - 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 Group resource payload containing the required displayName and schema identifiers for group creation.

string
required
length ≥ 1

Human-readable name for the group used for display in user interfaces and group management operations. This field is required when creating a new group.

string
length ≤ 255

Optional external identifier defined by the client or identity provider for mapping this group to an external system record.

schemas
array of strings
required
length ≥ 1

SCIM schema identifiers array indicating this resource follows the core Group schema as defined in SCIM 2.0 specification (RFC 7643).

schemas*
Allowed:
Responses

Updated 4 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 4 days ago