Skip to main content

Create SMS Campaign

Create a new SMS campaign in DRAFT status.

Endpoint​

POST https://api.campaignlark.com/v1/sms-campaigns

Request Body​

FieldTypeRequiredDescription
namestringrequiredCampaign name. Must be 1–255 characters.

Sample Request​

POST https://api.campaignlark.com/v1/sms-campaigns
Content-Type: application/json

{
  "name": "Summer Sale SMS"
}

Response​

Success — 201 Created​

{
  "error": null,
  "data": {
    "id": "64f1a2b3c4d5e6f7a8b9c0d1",
    "workspace_id": 42,
    "name": "Summer Sale SMS",
    "message": "",
    "audience": [],
    "status": "DRAFT",
    "statistics": {
      "sent": 0,
      "delivered": 0,
      "clicked": 0,
      "failed": 0,
      "unsubscribed": 0,
      "suppressed": 0
    },
    "created_at": "2025-06-30T12:00:00Z",
    "updated_at": "2025-06-30T12:00:00Z"
  }
}

Errors​

StatusMessageCause
400Please provide a valid request body.The request body could not be parsed.
400Please provide a name for this campaign.name is empty or whitespace.
400The campaign name must be 255 characters or less.name exceeds 255 characters.