Skip to main content
POST
/
projects
/
{projectId}
/
onboarding-metadata
Submit project onboarding metadata
curl --request POST \
  --url https://apix.spotzee.com/api/client/projects/{projectId}/onboarding-metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "wants_consultation": false,
  "marketing_emails": true
}
'
{
  "project_id": 42,
  "wants_consultation": true,
  "marketing_emails": true,
  "created_at": "<string>",
  "updated_at": "<string>",
  "plans_shopify_woocommerce": true,
  "industry": "ecommerce_retail",
  "referral_source": "google_search"
}

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Organisation-scoped admin API key (ok_…). Pass in the Authorization: Bearer <key> header. Used to manage projects and other organisation-level resources.

Path Parameters

projectId
integer | null

Numeric project identifier.

Example:

42

Body

application/json

Submit (or replace) the onboarding survey for a project. Idempotent — repeated calls with the same project upsert the existing record.

wants_consultation
boolean
required

Required. Set to true to request a setup consultation; false otherwise.

Example:

false

marketing_emails
boolean
required

Required. Set to true to opt in to product marketing emails; false otherwise.

Example:

true

plans_shopify_woocommerce
boolean | null

Self-reported intent to integrate with a popular ecommerce platform.

industry
enum<string> | null

Self-reported industry classification for the organisation behind this project.

Available options:
ecommerce_retail,
saas_technology,
marketing_agency,
healthcare,
education,
financial_services,
real_estate,
hospitality_travel,
manufacturing,
media_entertainment,
nonprofit,
professional_services,
other
referral_source
enum<string> | null

How the organisation discovered the platform.

Available options:
google_search,
social_media,
linkedin,
youtube,
friend_referral,
blog_article,
podcast,
newsletter,
paid_ad,
conference_event,
other

Response

The persisted onboarding metadata record.

Onboarding survey responses captured during a project’s first-run wizard.

project_id
integer
required

Numeric project identifier this onboarding record belongs to.

Example:

42

wants_consultation
boolean
required

When true, the organisation has requested a setup consultation.

marketing_emails
boolean
required

When true, the organisation has opted in to receive product marketing emails.

created_at
string | null
required

Time the onboarding record was created. ISO 8601.

updated_at
string | null
required

Time the onboarding record was last modified. ISO 8601.

plans_shopify_woocommerce
boolean | null

Self-reported intent to integrate with a popular ecommerce platform.

industry
enum<string> | null

Self-reported industry classification for the organisation behind this project.

Available options:
ecommerce_retail,
saas_technology,
marketing_agency,
healthcare,
education,
financial_services,
real_estate,
hospitality_travel,
manufacturing,
media_entertainment,
nonprofit,
professional_services,
other
referral_source
enum<string> | null

How the organisation discovered the platform.

Available options:
google_search,
social_media,
linkedin,
youtube,
friend_referral,
blog_article,
podcast,
newsletter,
paid_ad,
conference_event,
other