[ Web Proxy ]
URL:
Viewing: https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/insert [Back]  [Original]
Method: tables.insert  |  BigQuery  |  Google Cloud Documentation Skip to main content
Google Cloud Documentation [Google Cloud Documentation]
Technology areas Cross-product tools
Search:
Console
[]
Start free
Overview Guides Reference Samples Resources
Google Cloud Documentation [Google Cloud Documentation]
Send feedback

Method: tables.insert Stay organized with collections Save and categorize content based on your preferences.

Creates a new, empty table in the dataset.

IAM Permissions

Requires the bigquery.tables.create permission on the dataset.

HTTP request

POST https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/datasets/{datasetId}/tables

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. Project ID of the new table
datasetId

string

Required. Dataset ID of the new table

Request body

The request body contains an instance of Table.

Response body

If successful, the response body contains a newly created instance of Table.

Authorization scopes

Requires one of the following OAuth scopes:

For more information, see the Authentication Overview.

Send feedback

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-05-30 UTC.

Need to tell us more? [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-05-30 UTC."],[],[]]
Web Proxy Viewer  |  New URL  |  Original Page