---
updatedAt: 2026-06-25T13:10:13.000Z
agentTools:
  projectIndex: https://marketing.developer.dotdigital.com/llms.txt
---

# Update SMS campaign

Updates an existing SMS campaign, as long as the campaign has not been sent.

<br />

<span class="callRateMedium" />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "SMS campaigns",
    "version": "2.0.1",
    "description": "Create and manage SMS campaigns. Use this API to create, retrieve, update, copy,\nand delete SMS campaigns, and to send individual SMS messages to a specified\ntelephone number."
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "x-samples-languages": [
    "curl",
    "csharp",
    "java",
    "javascript",
    "node",
    "python",
    "php",
    "ruby"
  ],
  "externalDocs": {
    "description": "Learn more about Dotdigital APIs",
    "url": "https://developer.dotdigital.com"
  },
  "servers": [
    {
      "url": "https://{region}-api.dotdigital.com",
      "variables": {
        "region": {
          "default": "r1",
          "enum": [
            "r1",
            "r2",
            "r3"
          ],
          "description": "The Dotdigital region id your account belongs to"
        }
      }
    }
  ],
  "security": [
    {
      "basicAuth": []
    }
  ],
  "paths": {
    "/v2/sms/campaigns/{campaignId}": {
      "parameters": [
        {
          "in": "header",
          "name": "x-ddg-integration-token",
          "required": false,
          "description": "If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.",
          "schema": {
            "type": "string",
            "pattern": "/^(?:\\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\\}{0,1})$/",
            "example": "5a96bc79-19a7-4544-973b-e2da0c9136f9"
          }
        },
        {
          "name": "campaignId",
          "in": "path",
          "description": "The ID of the campaign.",
          "required": true,
          "example": 12345,
          "schema": {
            "type": "integer"
          }
        }
      ],
      "put": {
        "summary": "Update SMS campaign",
        "deprecated": false,
        "description": "Updates an existing SMS campaign, as long as the campaign has not been sent.",
        "operationId": "update-sms-campaign",
        "tags": [
          "SMS campaigns"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "message"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 255,
                    "description": "The name of the SMS campaign that is being created. Maximum: 255 characters."
                  },
                  "message": {
                    "type": "string",
                    "maxLength": 1600,
                    "description": "The message content of the SMS campaign that is being created."
                  },
                  "sendingIdentity": {
                    "type": "string",
                    "maxLength": 15,
                    "description": "The sending identity (From name) to use in the SMS campaign. If a sending identity is specified, it must exist on your account as a sending identity (found in ''SMS from names''). If you don''t specify a sending identity, the default identity from your account is used for this SMS campaign. Maximum: 15 characters."
                  },
                  "toggleShortLinks": {
                    "type": "boolean",
                    "description": "Defines whether or not the new campaign is going to shorten links within the SMS content. If specified as true, it validates all links in the SMS message to look for any formatting errors. If errors are found, an error is returned."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "description": "The SMS camapigns unique id.",
                      "default": 0,
                      "examples": [
                        1
                      ]
                    },
                    "name": {
                      "type": "string",
                      "description": "The SMS campaigns name.",
                      "examples": [
                        "SMS Test Campaign"
                      ]
                    },
                    "message": {
                      "type": "string",
                      "description": "The SMS message.",
                      "examples": [
                        "Test SMS campaign message content"
                      ]
                    },
                    "sendingIdentity": {
                      "type": "string",
                      "description": "Who the SMS is sent from.",
                      "examples": [
                        "dotdigital"
                      ]
                    },
                    "sendingIdentityId": {
                      "description": "The unique id for the sending identity.",
                      "type": "integer",
                      "examples": [
                        1234
                      ]
                    },
                    "toggleShortLinks": {
                      "description": "Whether link shortening is enabled or not.",
                      "type": "boolean",
                      "examples": [
                        true
                      ]
                    },
                    "status": {
                      "description": "The SMS campaigns status.",
                      "type": "string",
                      "examples": [
                        "unsent"
                      ]
                    }
                  }
                },
                "examples": {
                  "Result": {
                    "summary": "Result",
                    "value": {
                      "id": 10240,
                      "name": "An updated name",
                      "sendingIdentityId": 4623,
                      "sendingIdentity": "dotdigital",
                      "toggleShortLinks": true,
                      "status": "Unsent",
                      "message": "An updated message"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "examples": [
                        "The Name field is required.The Message field is required. ERROR_SMS_INVALID"
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```

# Sibling pages

* [Create SMS campaign](https://marketing.developer.dotdigital.com/reference/create-sms-campaign.md)
* [Copy SMS campaign](https://marketing.developer.dotdigital.com/reference/copy-sms-campaign.md)
* [Get SMS campaigns](https://marketing.developer.dotdigital.com/reference/get-sms-campaigns.md)
* [Get SMS campaign](https://marketing.developer.dotdigital.com/reference/get-sms-campaign.md)
* [Delete SMS campaign](https://marketing.developer.dotdigital.com/reference/delete-sms-campaign.md)
* [Send SMS message](https://marketing.developer.dotdigital.com/reference/send-sms-message.md)