Creates a new named integration for the specified CSPM app. name must be unique across all of this tenant's integrations, regardless of app type. The cleartext token and ingest URL are returned once and never stored -- copy them now, since the token cannot be retrieved again (use the rotate endpoint to issue a new one if it's lost).
Request body for creating a new CSPM integration
CSPM application type (e.g. wiz)
Unique, tenant-wide name for this integration (across all app types). Used to address this specific integration afterwards; can be changed later via the update endpoint.
Optional description for this integration
Integration created successfully
Response returned on integration creation or token rotation -- token is shown only once
CSPM application type
Unique, tenant-wide name given to this integration at creation
Description of this integration
Cleartext token -- store securely, will not be shown again
URL to which CSPM events should be sent (
Timestamp when the active token was created. Updated on each rotation -- it tracks the token, not the integration record -- so this reflects when the token was last rotated, not necessarily when the integration itself was first created.
The app's outbound webhook payload/action template, to be pasted as-is into the CSPM tool's own webhook/action configuration. Identical for every integration of a given app type. Absent if the app has no such template.
Unsupported app, blank name, or name already in use by another integration