Skip to main content
POST
/
organisations
/
{orgId}
/
workspaces
/
{workspaceId}
/
opportunities
Create new opportunity
curl --request POST \
  --url https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}/opportunities \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Improve Customer Onboarding Experience",
  "description": "Streamline the initial user setup process to reduce drop-offs",
  "createdBy": "user",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ownerId": "d4e71c2b-a498-42af-b7f5-69de06a0d7c4",
  "solutionIds": [
    "<string>"
  ],
  "insightIds": [
    "<string>"
  ],
  "outcomeIds": [
    "<string>"
  ]
}
'
{
  "data": {
    "id": "f5d8df32-60b4-417a-8b83-8d4dcb4e88e1",
    "read": false,
    "status": "New",
    "title": "Improve Customer Onboarding Experience",
    "description": "Streamline the initial user setup process to reduce drop-offs",
    "solutionsGeneratingState": "initial",
    "createdBy": "user",
    "hideContent": false,
    "createdAt": "2023-01-01T00:00:00.000Z",
    "updatedAt": "2023-01-01T00:00:00.000Z",
    "hasUnseenInsights": false,
    "solutions": [],
    "insights": [],
    "outcomes": [],
    "topics": [],
    "ownerId": "d4e71c2b-a498-42af-b7f5-69de06a0d7c4"
  }
}

Authorizations

​
Authorization
string
header
required

JWT authentication for organization-scoped endpoints.

​
Authorization
string
header
required

API key authentication for public API endpoints. This key is scoped by workspace so a unique key is required per workspace within an organisation.

Path Parameters

​
orgId
string
required

Organization ID

​
workspaceId
string
required

Workspace ID

Body

application/json

Request schema for creating an opportunity

​
title
string
required

Title of the opportunity

Example:

"Improve Customer Onboarding Experience"

​
description
string
required

Description of the opportunity

Example:

"Streamline the initial user setup process to reduce drop-offs"

​
createdBy
enum<string>
required

How the opportunity was created

Available options:
user,
generated
Example:

"user"

​
id
string<uuid>
​
ownerId
string

ID of the opportunity owner

Example:

"d4e71c2b-a498-42af-b7f5-69de06a0d7c4"

​
solutionIds
string[]
​
insightIds
string[]
​
outcomeIds
string[]

Response

Opportunity created successfully

Response containing a single opportunity

​
data
object
required

Opportunity data