Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedAgent setupWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference
Skills for agents

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
ProjectsDomains

Get Domain

View as MarkdownAgent setup

Fetches a domain plus its email DNS config and whether verification jobs are still running. Once a check has been asked for and that capability is not live yet, this also writes the status the provider reports now — sending and tracking from Resend, inbound from Resend, shortlinks from Vercel — so the domain list does not stay Waiting on DNS after the records have verified. Returns 404 if no domain matches.

GET
/projects/{projectId}/domains/{domainId}

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

application/json

curl -X GET "https://example.com/projects/string/domains/string"
{  "domain": {    "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  },  "emailConfig": {    "capabilities": {      "receiving": "string",      "sending": "string"    },    "created_at": "string",    "id": "string",    "name": "string",    "records": [      {        "name": "string",        "priority": 0,        "record": "string",        "status": "string",        "ttl": "string",        "type": "string",        "value": "string"      }    ],    "region": "string",    "status": "pending"  },  "emailVerificationJobActive": true,  "emailVerificationStarted": true,  "receivingVerificationJobActive": true,  "receivingVerificationStarted": true,  "shortlinkVerificationJobActive": true,  "shortlinkVerificationStarted": true}

List Domains

Lists the project's domains. Filter by sending status, shortlink state, or readyToSend (ACTIVE and tracking verified — use that when picking a from-domain).

Create Domain

Registers a hostname on the project. Names are unique across Saasco. Reusing one that belongs to another project returns 400. Creating one does not enable sending, receiving, or shortlinks and does not return DNS records. Call Activate Email Sending, Activate Email Receiving, or Enable Shortlink, then read the records from Get Domain (emailConfig.records) or Get Email Receiving Config, add them at the DNS host, and call Verify Email DNS, Verify Email Receiving DNS, or Verify Shortlink.