Skip to main content

createIntegration

form schema

Create and activate an integration for your organization.

Configures a new integration of the specified type. The config and auth fields must conform to the JSON schemas returned by integrationTypes. Returns an IntegrationActivation with one-time setup instructions that may include sensitive credentials.

Each organization can have at most one integration per type.

mutation {
  createIntegration(
    organizationId: "my-org"
    id: "aws-cost-and-usage-reports"
    input: {
      config: "{\"bucket\": \"my-cur-bucket\", \"region\": \"us-east-1\"}"
      auth: "{\"roleArn\": \"arn:aws:iam::123456789012:role/MassdriverCUR\"}"
    }
  ) {
    result {
      id
      status
      instructions
    }
    successful
    messages { field message }
  }
}
createIntegration(
  organizationId: ID!
  id: ID!
  input: CreateIntegrationInput!
): IntegrationActivationPayload

Form Schema​

This mutation supports dynamic form generation using JSON Schema.

Loading schema...

Arguments​

createIntegration.organizationId ● ID! non-null scalar {#organization-id}​

Your organization's unique identifier.

createIntegration.id ● ID! non-null scalar {#id}​

The integration type to configure (e.g., "aws-cost-and-usage-reports").

createIntegration.input ● CreateIntegrationInput! non-null input {#input}​

Create and activate an integration for your organization. The config and auth payloads must conform to the integration type's configSchema and authSchema respectively.

Type​

IntegrationActivationPayload object​