Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

Email Marketing

Knowledge

Support

Projects

getList ProjectsgetGet ProjectpostUpdate ProjectdelDelete Project
Settings

Get Project

Fetches a single project along with its app configs: one entry per Saasco app the project has enabled, carrying that app's activation and setup-completion state. Returns 404 if the project does not exist.

GET
/projects/{projectId}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to fetch.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string"
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "name": "string",
  "tagline": "string",
  "slug": "string",
  "balance": 0,
  "balanceVersion": -9007199254740991,
  "thumbnail": "string",
  "stripeCustomerId": "string",
  "testStripeCustomerId": "string",
  "autoTopUpEnabled": true,
  "meta": {
    "completedSetupSteps": [
      "sdk"
    ],
    "contactListVisibleColumns": [
      {
        "id": "string",
        "order": 0
      }
    ],
    "defaultEmailCampaignSendOrder": {
      "direction": "asc",
      "propertyKey": "string"
    },
    "defaultEmailFromDomain": "string",
    "defaultEmailFromName": "string",
    "defaultEmailFromUsername": "string",
    "hasCompletedOnboarding": true,
    "knowledgeArticlesVisibleColumns": [
      {
        "id": "string",
        "order": 0
      }
    ],
    "timezone": "string",
    "useCases": [
      "onboarding"
    ]
  },
  "autoTopUpAmount": 20,
  "autoTopUpThreshold": 10,
  "appConfigs": [
    {
      "id": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "appId": "string",
      "activated": true,
      "setupCompleted": true,
      "projectId": "string"
    }
  ]
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

List Projects

Lists the projects the caller can reach, each with its app configs. API keys are scoped to a single project, so an API-key caller always gets exactly that one project back. The paging and sorting parameters are only meaningful for session callers, who receive every project they are a member of.

Update Project

Updates a project's settings. Only the fields present in `changes` are written, so this is a partial update despite the POST. Slugs are unique across Saasco. Reusing one that belongs to another project returns 409.