Skip to content
extensions / Commerce extension
POST/api/projects/{project_id}/shopify/connect/start

Start Connect

Begins the Shopify OAuth connection flow for a project and returns the authorization URL.

POST

Authentication

Requirement
Required
Credential type
Bearer API key
Scopes
Not specified

Permissions

  • Requires an authenticated storefront session.

Headers

NameRequiredTypeDetails
AuthorizationYesNot specified
Description: Bearer credential used to authenticate the request.

Path Parameters

NameRequiredTypeDetails
project_idYesNot specified
Description: Target project identifier.

Query Parameters

Request Body

Schema: StartShopifyConnectBody

FieldRequiredTypeDetails
store_domainYesstring
Description: Text value.
return_toNostring
Description: Text value.
auto_importNoboolean
Description: Boolean flag.
api_versionNostring
Description: Text value.
import_productsNoboolean
Description: Boolean flag.
import_collectionsNoboolean
Description: Boolean flag.
import_ordersNoboolean
Description: Boolean flag.
import_customersNoboolean
Description: Boolean flag.
import_pagesNoboolean
Description: Boolean flag.

Response Body

Example 200 response

json
{
  "auth_url": "string"
}

Errors

400 BAD_REQUEST500 INTERNAL_SERVER_ERROR

Availability

Available in
v0.1.0
Available since
v0.1.0
Implementation
Available
Deprecation
Not specified
Rate limits
Not specified