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 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 StatsputUpdate Campaign Message
Email MarketingCampaigns

List Email Campaigns

View as MarkdownAgent setup

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

Update Clean Settings

Replaces the project's list-hygiene settings. Unlike most update endpoints here, `settings` is written whole rather than merged, so send the complete object. Enabling automatic validation applies to contacts created from then on; it does not retroactively validate existing ones.

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.