Workspaces

POST /public/v1/workspace-products

Create a new workspace product used as context for AI-generated outreach.

POST /public/v1/workspace-products

POST /public/v1/workspace-products

curl --request POST \
  --url 'https://api.joinvalley.co/public/v1/workspace-products' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "statusCode": 1,
  "status": true,
  "message": "<string>",
  "data": {
    "workspace_product": {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "access_scope": "<string>",
      "created_at": "<string>"
    }
  }
}

Default Response

Authorizations

  • x-api-key string required header

    Your Valley API key.

Request Body

application/json
  • workspaceId string required

    ID of the workspace to create the product in.

  • name string required

    Product or company name.

  • description string required

    Short description of what you offer.

  • painPoints[] string required array

    Customer pain points your product addresses.

  • valueProposition[] string required array

    Key value propositions of your product.

  • proofPoints[] string required array

    Social proof, case studies, or stats that back your claims.

  • cta string

    Optional. Call-to-action text used in outreach messages.

  • meetingLink string

    Optional. Booking or meeting link to include in outreach.

  • outreachLanguage string

    Optional. Language for outreach messages (e.g. "English", "French"). Defaults to "English".

  • websiteUrl string

    Optional. Company / website URL (shown as "Company URL" in Studio).

  • productUrl string

    Optional. Product URL.

  • customerProfile string

    Optional. Ideal Customer Profile (ICP). Free text; Studio uses an "ALWAYS SCORE HIGH: / ALWAYS SCORE LOW:" convention inside this text to drive prospect scoring.

  • competitors string

    Optional. Competitors, as free text.

  • extraMaterials[] string array

    Optional additional context or materials for AI message generation.

  • qna[] object array

    Optional Q&A pairs that give the AI more context about your product.

    + Show Child Attributes
    • question string required
    • answer string required
  • accessScope string enum enum

    Who can use this product. OWNER = private to you; WORKSPACE = shared across the workspace (ADMIN/OWNER only). Allowed values: OWNER, WORKSPACE.

Response

application/json
  • statusCode number
  • status boolean
  • message string
  • data object
    + Show Child Attributes
    • workspace_product object
      + Show Child Attributes
      • id string
      • name string
      • description string
      • access_scope string
      • created_at string