Skip to main content
Snowflake logo
  • Category: databases
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 17
  • Triggers: 0
  • Slug: SNOWFLAKE
  • Version: 20261101_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own Snowflake OAuth credentials with Composio, see How to create OAuth credentials for Snowflake.
Example Snowflake SQL to create a security integration for OAuth:
Ensure the OAuth app and Snowflake roles, databases, and schemas are configured correctly for the integration.
Yes. Snowflake OAuth is tied to the user’s Snowflake account and security integration. There is not a single generic Snowflake OAuth app that can safely cover every account, role setup, redirect URI, and security policy.For a production integration, each Snowflake user should bring the OAuth client credentials from the security integration configured in their own Snowflake account. Create a Composio auth config with those credentials, then let the user connect with the account identifier and permissions for that Snowflake account. This keeps the connection aligned with the user’s Snowflake roles, databases, schemas, and refresh-token policy.

Tools

Slug: SNOWFLAKE_CANCEL_STATEMENT_EXECUTIONCancels the execution of a running SQL statement. Use this action to stop a long-running query.

Input Parameters

string
Unique ID (a UUID) of the API request. This is an optional parameter that can be used to track the request.
string
required
The handle of the statement to be cancelled. This can be obtained from the response of the execute_statement action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_CHECK_STATEMENT_STATUSChecks a submitted SQL statement by handle and retrieves results for a completed statement, optionally for a specified partition. If execution is still in progress, the tool reports an execution error indicating that it should be retried.

Input Parameters

integer
The partition number to return. The size of each partition is determined by Snowflake.
string
Unique ID (UUID) of the API request for idempotency.
string
required
The handle of the statement to be checked.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_DROP_WAREHOUSEDrops a Snowflake warehouse by its case-sensitive name. Requires OWNERSHIP privilege on the warehouse. Optionally use the if-exists condition to avoid an error when the warehouse is absent.

Input Parameters

string
required
Identifier (i.e. name) for the warehouse to drop. The value is case-sensitive and must match the exact warehouse name in Snowflake.
boolean
If true, the endpoint does not throw an error if the warehouse does not exist. It returns a 200 success response without taking action. If false, the endpoint throws an error if the warehouse doesn’t exist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_EXECUTE_SQLSubmits SQL statements to Snowflake, including SELECT, DDL, and DML. Completed single-statement responses may include result rows and metadata; long-running statements may return a handle, and multi-statement responses provide handles for individual results.

Input Parameters

string
Role name to use for execution (case-sensitive). If not specified, uses the user’s DEFAULT_ROLE setting.
integer
Execution timeout in seconds. Set to 0 for maximum timeout (604800 seconds). If not specified, uses the default timeout.
object
Values of bind variables in the SQL statement. Use this for parameterized queries to prevent SQL injection.
string
Database name to use for execution (case-sensitive). If not specified, uses the user’s DEFAULT_NAMESPACE setting.
string
required
SQL statement(s) to execute. Supports SELECT queries, DDL (CREATE, ALTER, DROP), and DML (INSERT, UPDATE, DELETE). Multiple statements can be separated by semicolons; they will be executed in sequence automatically. When querying INFORMATION_SCHEMA, always filter on both table_schema and table_catalog and wrap mixed AND/OR conditions in parentheses. For multi-statement batches, test critical sections in isolation first — a single failing statement obscures root cause.
string
Warehouse name to use for query execution (case-sensitive). Required for queries that need compute resources. If not specified, uses the user’s DEFAULT_WAREHOUSE setting. Suspended or undersized warehouses cause high latency or timeouts; verify the warehouse is active and appropriately sized before execution.
object
Session parameters to set for the statement execution. These are Snowflake session-level parameters.
string
Schema name to use for execution (case-sensitive). If not specified, uses the user’s DEFAULT_NAMESPACE setting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_FETCH_CATALOG_INTEGRATIONRetrieves detailed configuration and metadata for a specific catalog integration. Catalog integrations allow Snowflake to connect to external Apache Iceberg catalogs (AWS Glue, Snowflake Open Catalog/Polaris, or Apache Iceberg REST catalogs) to query Iceberg tables managed by those external systems.

Input Parameters

string
required
The name (identifier) of the catalog integration to fetch details for. This is case-sensitive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_ACTIVE_SCHEDULED_MAINTENANCESRetrieves a list of any active scheduled maintenances currently in the In Progress or Verifying state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_ALL_SCHEDULED_MAINTENANCESRetrieves up to 10 of the 50 most recent scheduled maintenances from Snowflake’s status page, including completed events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_COMPONENT_STATUSRetrieves the status of individual components, each listed with its current status.

Input Parameters

integer
Limit number of components returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_STATUS_ROLLUPRetrieves the status rollup for the entire page, including indicators and human-readable descriptions of the blended component status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_STATUS_SUMMARYRetrieves Snowflake’s public status summary, including overall status, component statuses, unresolved incidents, and upcoming or in-progress maintenance. Returns at most 50 components and 10 incidents and maintenances each; this is global service status, not account-specific information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_UNRESOLVED_INCIDENTSRetrieves a list of any unresolved incidents from the Snowflake status page. This endpoint returns incidents currently in the Investigating, Identified, or Monitoring state. Returns an empty list if there are no active incidents. This is a public status page API that does not require authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_GET_UPCOMING_SCHEDULED_MAINTENANCESRetrieves upcoming scheduled maintenances from Snowflake’s public status page. This action queries the Snowflake status API to get a list of any scheduled maintenance events that are still in the ‘Scheduled’ state (not yet started or completed). The response includes maintenance details such as impact level, scheduled time windows, incident updates, and direct links to the maintenance notices. Note: This uses Snowflake’s public status API and does not require authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_SHOW_DATABASESLists all databases for which you have access privileges. Shows database metadata including name, creation date, owner, retention time, and more. Can filter results and include dropped databases within Time Travel retention period.

Input Parameters

string
Role to use when executing the statement.
integer
Maximum number of rows to return. Cannot exceed 10000.
boolean
If true, returns only a subset of output columns (created_on, name, kind, database_name, schema_name).
boolean
If true, includes dropped databases that are still within Time Travel retention period.
integer
Timeout in seconds for statement execution.
string
Used with LIMIT for pagination. Returns results starting from databases whose names match this string.
string
Warehouse to use for the query (though SHOW DATABASES doesn’t require a running warehouse).
string
Filters results by databases whose names start with this string. Case-sensitive.
string
Filters results by database name using SQL wildcard pattern (% and _). Case-insensitive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_SHOW_SCHEMASLists all schemas for which you have access privileges. Shows schema metadata including name, creation date, owner, database, retention time, and more. Can filter results and include dropped schemas within Time Travel retention period.

Input Parameters

string
Role to use when executing the statement.
integer
Maximum number of rows to return. Cannot exceed 10000.
boolean
If true, returns only a subset of output columns (created_on, name, kind, database_name, schema_name).
boolean
If true, includes dropped schemas that are still within Time Travel retention period.
integer
Timeout in seconds for statement execution.
string
Database context for the query.
string
Scope for the command. Options: ‘ACCOUNT’, ‘DATABASE’, or a specific database name.
string
Used with LIMIT for pagination. Returns results starting from schemas whose names match this string.
string
Warehouse to use for the query (though SHOW SCHEMAS doesn’t require a running warehouse).
string
Filters results by schemas whose names start with this string. Case-sensitive.
string
Filters results by schema name using SQL wildcard pattern (% and _). Case-insensitive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_SHOW_TABLESLists accessible Snowflake tables in the requested scope, with metadata, filters, and optional dropped-table history. Results may be incomplete: only the initial response is returned, and an in-progress response can appear as an empty list.

Input Parameters

string
Role to use when executing the statement.
integer
Maximum number of rows to return. Cannot exceed 10000.
boolean
If true, returns only a subset of output columns (created_on, name, kind, database_name, schema_name).
string
Schema context for the query.
boolean
If true, includes dropped tables that are still within Time Travel retention period.
integer
Timeout in seconds for statement execution.
string
Database context for the query.
string
Scope for the command. Options: ‘ACCOUNT’, ‘DATABASE’, ‘SCHEMA’, or specific database/schema names.
string
Used with LIMIT for pagination. Returns results starting from tables whose names match this string.
string
Warehouse to use for the query (though SHOW TABLES doesn’t require a running warehouse).
string
Filters results by tables whose names start with this string. Case-sensitive.
string
Filters results by table name using SQL wildcard pattern (% and _). Case-insensitive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_SUBMIT_SQL_STATEMENTDEPRECATED: Submits a SQL statement to Snowflake for execution. Results may be returned immediately; longer-running statements may return a handle for status checks.

Input Parameters

string
Role to use when executing the statement. The value in this field is case-sensitive. If you omit this field, the SQL API uses the value of the DEFAULT_ROLE property of the user.
string
Schema in which the statement should be executed. The value in this field is case-sensitive. If you omit this field, the SQL API uses the schema from the value of the DEFAULT_NAMESPACE property of the user.
integer
Timeout in seconds for statement execution. If the execution of a statement takes longer than the specified timeout, the execution is automatically canceled. To set the timeout to the maximum value (604800 seconds), set timeout to 0. If this field is not set, the timeout specified by the STATEMENT_TIMEOUT_IN_SECONDS parameter is used.
object
Values of bind variables in the SQL statement. When executing the statement, Snowflake replaces placeholders ( ? and :name) in the statement with these specified values.
string
Database in which the statement should be executed. The value in this field is case-sensitive. If you omit this field, the SQL API uses the database from the value of the DEFAULT_NAMESPACE property of the user.
string
required
The SQL statement to execute. Unquoted identifiers are automatically uppercased by Snowflake; quote identifiers to preserve case. When querying INFORMATION_SCHEMA views, filter by both table_schema and table_catalog to avoid results from unintended databases or schemas.
string
Warehouse to use when executing the statement. The value in this field is case-sensitive. If you omit this field, the SQL API uses the value of the DEFAULT_WAREHOUSE property of the user.
object
Session parameters that you want to set for this request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SNOWFLAKE_VALIDATE_CREDENTIALChecks Snowflake credentials by submitting a lightweight session query, useful before running other account operations. Returns a validity flag, a session ID when available, and a status message. Basic authentication is not supported for this check.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not