Skip to main content

createServiceAccount

form schema

Create a new service account in your organization.

Returns the service account with its secret token. The secret is only included in this response — store it immediately in a secure location (e.g., a secrets manager or CI/CD environment variable). If you lose the secret, you must delete the service account and create a new one.

The new service account has no permissions until you add it to a group. Requires organization_admin permissions.

Example:

mutation {
  createServiceAccount(
    organizationId: "my-org"
    input: { name: "ci-deploy-bot", description: "GitHub Actions deployer" }
  ) {
    result {
      id
      name
      secret
    }
    successful
    messages { field message }
  }
}
createServiceAccount(
  organizationId: ID!
  input: CreateServiceAccountInput!
): ServiceAccountWithSecretPayload

Form Schema​

This mutation supports dynamic form generation using JSON Schema.

Loading schema...

Arguments​

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

Your organization's unique identifier.

createServiceAccount.input ● CreateServiceAccountInput! non-null input {#input}​

Create a new service account for programmatic API access.

Type​

ServiceAccountWithSecretPayload object​