API ReferenceCampaignsDelete campaign
DELETE/v2/campaigns/:id

Delete campaign

Deletes a single campaign you own. By default its leads are deleted too; pass ?keepLeads=true to migrate them to your unassigned leads list instead.

Stablescope: write API KeyLearn about API scopes →

Request

AuthorizationBearer YOUR_API_KEY

Parameters

FieldTypeRequiredDescription
idstringRequiredCampaign ID.
keepLeadsbooleanOptionaltrue to keep the campaign's leads (moved to the unassigned leads list) instead of deleting them.
curl -X DELETE "https://api.stynar.com/v2/campaigns/cmp_abc123?keepLeads=true" \
  -H "Authorization: Bearer esk_your_key_here"

Response

✓ 200 OK
200 response
{
  "campaignId": "cmp_abc123",
  "leadsDeleted": 0
}

Response fields

Errors

StatusCodeMeaning
✕ 404 Not FoundNOT_FOUNDCampaign doesn't exist or isn't yours.
✕ 401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
✕ 403 ForbiddenAPI_ACCESS_DISABLEDAPI access is turned off for your account.
✕ 403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
✕ 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 →