API ReferenceCampaignsBulk delete campaigns
POST/v1/campaigns/bulk-delete

Bulk delete campaigns

Deletes multiple campaigns in one call instead of one request per campaign.

Stablescope: write API KeyLearn about API scopes →

Best-effort, not all-or-nothing

Each campaign ID is deleted independently — one missing or already-deleted ID doesn't block the rest. Check failed in the response for anything that didn't go through, same convention as Launch a campaign.

Request

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Parameters

FieldTypeRequiredDescription
campaignIdsstring[]Required1–50 campaign IDs.
keepLeadsbooleanOptionalApplies to every campaign in the batch — same meaning as Delete campaign's ?keepLeads.
curl -X POST "https://api.stynar.com/v1/campaigns/bulk-delete" \
  -H "Authorization: Bearer esk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"campaignIds":["cmp_abc123","cmp_def456"],"keepLeads":true}'

Response

200 OK
200 response
{
  "deleted": [
    {
      "campaignId": "cmp_abc123",
      "leadsDeleted": 0
    }
  ],
  "failed": [
    {
      "campaignId": "cmp_def456",
      "reason": "NOT_FOUND"
    }
  ]
}

Response fields

Errors

StatusCodeMeaning
401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
403 ForbiddenAPI_ACCESS_DISABLEDYour account doesn't currently have API access.
403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
404 Not FoundNOT_FOUNDUnknown route, or a resource that doesn't exist / isn't yours.
409 ConflictCONFLICTThe action can't be applied to the resource's current state.
429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →