Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
Set up Email MarketingDraft a campaign
getList Email CampaignsgetGet Email CampaignpostCreate Email CampaignputUpdate Email CampaignpostDuplicate Email CampaigndelDelete Email CampaignpostSend Email CampaignpostResume Sending Email CampaignpostStop Sending Email CampaignpostSend Test EmailgetCount Campaign EmailsgetGet Email Stats
Set up a workflow
Email MarketingCampaigns

List Email Campaigns

Lists the project's campaigns with status and send progress. Audience, UTM, A/B config, and message bodies are omitted — fetch a campaign by id for those. Optionally narrow with type or types. Omit take to return every matching campaign; the dashboard passes take (max 100) and after to page.

GET
/projects/{projectId}/email-campaigns

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to list campaigns for.

Query Parameters

afterstring

Return campaigns created before this campaign id. Requires the same type / types and sort as the previous page.

takeinteger

Maximum campaigns to return, newest first. Omit to return every matching campaign.

typestring

Return only campaigns of this kind: STANDARD for a one-off broadcast, AUTOMATION for a triggered send, AB_TEST for a split test. Omit for all three.

Value in: "STANDARD" | "AUTOMATION" | "AB_TEST"
typesarray<string>

Return only campaigns of these kinds. Takes precedence over type when both are set.

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/email-campaigns"
[
  {
    "createdAt": "string",
    "id": "string",
    "name": "string",
    "projectId": "string",
    "sendCount": 0,
    "sentAt": "string",
    "status": "DRAFT",
    "type": "STANDARD",
    "updatedAt": "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": []
}

Draft a campaign

What an agent needs to draft an email campaign through the MCP.

Get Email Campaign

Fetches a single campaign with its messages, audience definition, status, and send progress. Returns 404 if the campaign does not exist in this project.