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 DomainsgetGet DomainpostCreate DomainpostUpdate DomaindelDelete DomainpostActivate Email SendingpostActivate Email ReceivingdelDisable Email SendingdelDisable Email ReceivingpostEnable ShortlinkdelDisable ShortlinkpostEnable Link TrackinggetGet Email Receiving ConfiggetGet Sender ReputationgetGet Sender Reputation By Domain NamegetGet Domain Warmup StatuspostVerify Email DNSpostVerify Email Receiving DNSpostVerify Shortlink
Add DNS records
ProjectsDomains

Verify Shortlink

Re-checks Vercel DNS for custom-domain shortlinks and updates verification status. Project members are emailed on the first VALID transition. Starts a verification job if the records are still invalid. Returns 400 if shortlinks are not enabled.

POST
/projects/{projectId}/domains/{domainId}/verify-shortlink

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the domain.

domainIdrequiredstring

ID of the domain.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://www.saasco.com/api/v2/projects/string/domains/string/verify-shortlink"
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "emailStatus": "INACTIVE",
  "emailProvider": "string",
  "emailProviderDomainId": "string",
  "emailReceivingStatus": "INACTIVE",
  "emailReceivingProviderId": "string",
  "trackingSubdomain": "string",
  "trackingVerificationStatus": "PENDING",
  "shortlinkEnabled": true,
  "vercelConfigured": true,
  "vercelVerificationStatus": "PENDING",
  "vercelVerificationError": "string",
  "vercelVerificationDNS": [
    {
      "domain": "string",
      "reason": "string",
      "type": "string",
      "value": "string"
    }
  ],
  "emailVerificationRequestedAt": "string",
  "receivingVerificationRequestedAt": "string",
  "shortlinkVerificationRequestedAt": "string",
  "senderReputationComputedAt": "string",
  "warmupStatus": "PENDING",
  "warmupStartedAt": "string",
  "warmupWindowStartedAt": "string",
  "projectId": "string",
  "name": "string",
  "senderReputation": 50,
  "warmupDay": 0,
  "warmupSentCount": 0
}
{
  "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": []
}

Verify Email Receiving DNS

Re-checks inbound MX records and starts the inbound verification job, which is what emails 'verified'. Returns verified: true when receiving is ACTIVE. Returns 400 if inbound email is not enabled for the domain.

Add DNS records

How an agent walks someone through adding Saasco DNS records at their DNS host.