Skip to main content
POST
Create integration connection

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
providerSlug
string
required

Provider slug for the integration. Call list-providers first to see the available slugs (e.g. 'aws', 'gcp', 'azure', 'github').

Example:

"aws"

organizationId
string

Auto-resolved from your API key / session. You can omit this; it is ignored by the server.

credentials
object

Provider-specific credential fields. Keys differ by provider — call get-provider-details for the exact shape. For AWS (Cloud Tests) the fields are: connectionName (display name), awsType ('aws-commercial' or 'aws-govcloud'), roleArn (auditor role), externalId (typically your org id), regions (string array), and optionally remediationRoleArn and awsScanMode ('comp_scanners' or 'security_hub'). Omit credentials for OAuth providers — use POST /v1/integrations/oauth/start instead.

Example:

Response

201 - undefined