Register a destination spreadsheet

POST

/destinations/google-sheets/connections/{connectionId}/sheets

Either creates a new Synci-managed spreadsheet (mode=create) or attaches
an existing spreadsheet the user selected (mode=attach).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://api.synci.io/oauth/authorize

Token URL: https://api.synci.io/oauth/token

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟢201

🟠401AuthenticationException

🟠403AuthorizationException

🟠404ModelNotFoundException

🟠422ValidationException

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.synci.io/api/v1/destinations/google-sheets/connections//sheets' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "create",
    "name": "string",
    "title": "string",
    "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
    "header_config": [
        "synci.account_id"
    ]
}'

Response Example

200 - Example 1

"string"

Modified at 2026-07-14 16:18:50

List destination spreadsheets for a connection

Get a destination spreadsheet