Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getList ShortlinksgetGet ShortlinkpostCreate ShortlinkputUpdate ShortlinkdelDelete ShortlinkgetGet Shortlink ClicksgetGet Shortlink Clicks CountgetGet Top Shortlinks
Shortlinks

Create Shortlink

Creates a short link on a domain that already belongs to the project. The domain has to be verified and have short links turned on.

POST
/projects/{projectId}/shortlinks

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that will own the short link.

Request Body

application/json

destinationURLrequiredstring

URL visitors are sent to when they open the short link.

Format: uri
shortLinkDomainrequiredstring

Hostname of the short link, for example go.example.com.

shortLinkPathrequiredstring

Path on that hostname, without a leading slash.

domainIdrequiredstring

ID of the domain that hosts the short link.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://www.saasco.com/api/v2/projects/string/shortlinks" \  -H "Content-Type: application/json" \  -d '{    "destinationURL": "http://example.com",    "shortLinkDomain": "string",    "shortLinkPath": "string",    "domainId": "string"  }'
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "destinationURL": "http://example.com",
  "shortLinkDomain": "string",
  "shortLinkPath": "string",
  "projectId": "string",
  "domainId": "string"
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get Shortlink

Fetches one short link by id. Returns null when the project has no link with that id.

Update Shortlink

Updates a short link's destination, domain, or path. Omitted fields stay as they are. A new domain has to be verified and have short links turned on.