> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autosend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Campaign

> Update an existing campaign's settings, content, or scheduling using the AutoSend API.

<RequestExample>
  ```bash cURL theme={null}
  curl --request PATCH \
    --url 'https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567' \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "name": "Spring Sale Newsletter - Final",
      "subject": "Last chance: Spring Sale ends tonight!",
      "previewText": "Up to 50% off — ends at midnight",
      "trackingClick": true,
      "trackingOpen": true
    }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567"
  headers = {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
  }
  payload = {
      "name": "Spring Sale Newsletter - Final",
      "subject": "Last chance: Spring Sale ends tonight!",
      "previewText": "Up to 50% off — ends at midnight",
      "trackingClick": True,
      "trackingOpen": True
  }

  response = requests.patch(url, json=payload, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567',
    {
      method: 'PATCH',
      headers: {
        Authorization: 'Bearer <token>',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        name: 'Spring Sale Newsletter - Final',
        subject: 'Last chance: Spring Sale ends tonight!',
        previewText: 'Up to 50% off — ends at midnight',
        trackingClick: true,
        trackingOpen: true,
      }),
    }
  );
  const data = await response.json();
  console.log(data);
  ```

  ```php PHP theme={null}
  <?php
  $curl = curl_init();
  curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_POSTFIELDS => json_encode([
      'name' => 'Spring Sale Newsletter - Final',
      'subject' => 'Last chance: Spring Sale ends tonight!',
      'previewText' => 'Up to 50% off — ends at midnight',
      'trackingClick' => true,
      'trackingOpen' => true,
    ]),
    CURLOPT_HTTPHEADER => [
      'Authorization: Bearer <token>',
      'Content-Type: application/json',
    ],
  ]);
  $response = curl_exec($curl);
  curl_close($curl);
  echo $response;
  ```

  ```go Go theme={null}
  package main

  import (
  	"bytes"
  	"encoding/json"
  	"fmt"
  	"io"
  	"net/http"
  )

  func main() {
  	payload := map[string]interface{}{
  		"name":          "Spring Sale Newsletter - Final",
  		"subject":       "Last chance: Spring Sale ends tonight!",
  		"previewText":   "Up to 50% off — ends at midnight",
  		"trackingClick": true,
  		"trackingOpen":  true,
  	}
  	body, _ := json.Marshal(payload)

  	req, _ := http.NewRequest("PATCH", "https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567", bytes.NewBuffer(body))
  	req.Header.Set("Authorization", "Bearer <token>")
  	req.Header.Set("Content-Type", "application/json")

  	client := &http.Client{}
  	resp, _ := client.Do(req)
  	defer resp.Body.Close()
  	respBody, _ := io.ReadAll(resp.Body)
  	fmt.Println(string(respBody))
  }
  ```

  ```java Java theme={null}
  import java.net.URI;
  import java.net.http.HttpClient;
  import java.net.http.HttpRequest;
  import java.net.http.HttpResponse;

  public class Main {
      public static void main(String[] args) throws Exception {
          String body = """
              {
                "name": "Spring Sale Newsletter - Final",
                "subject": "Last chance: Spring Sale ends tonight!",
                "previewText": "Up to 50% off — ends at midnight",
                "trackingClick": true,
                "trackingOpen": true
              }
              """;

          HttpClient client = HttpClient.newHttpClient();
          HttpRequest request = HttpRequest.newBuilder()
              .uri(URI.create("https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567"))
              .header("Authorization", "Bearer <token>")
              .header("Content-Type", "application/json")
              .method("PATCH", HttpRequest.BodyPublishers.ofString(body))
              .build();
          HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
          System.out.println(response.body());
      }
  }
  ```

  ```ruby Ruby theme={null}
  require 'net/http'
  require 'uri'
  require 'json'

  uri = URI('https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567')
  http = Net::HTTP.new(uri.host, uri.port)
  http.use_ssl = true

  request = Net::HTTP::Patch.new(uri)
  request['Authorization'] = 'Bearer <token>'
  request['Content-Type'] = 'application/json'
  request.body = {
    name: 'Spring Sale Newsletter - Final',
    subject: 'Last chance: Spring Sale ends tonight!',
    previewText: 'Up to 50% off — ends at midnight',
    trackingClick: true,
    trackingOpen: true
  }.to_json

  response = http.request(request)
  puts JSON.parse(response.body)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "id": "60d5ec49f1b2c72d9c8b4567",
      "name": "Spring Sale Newsletter - Final",
      "subject": "Last chance: Spring Sale ends tonight!",
      "previewText": "Up to 50% off — ends at midnight",
      "status": "draft",
      "sendMode": "immediate",
      "trackingClick": true,
      "trackingOpen": true,
      "createdAt": "2026-03-01T10:00:00.000Z",
      "updatedAt": "2026-03-15T14:30:00.000Z"
    }
  }
  ```
</ResponseExample>

### Authorizations

<ParamField path="Authorizations" type="string | header" required>
  Bearer authentication header of the form Bearer `<token>`, where `<token>` is your auth token.
</ParamField>

### Path Parameters

<ParamField path="campaignId" type="string" required>
  The id of the campaign to update.
</ParamField>

### Body

All body fields are optional. Only the fields provided will be updated.

<ParamField body="name" type="string">
  Display name of the campaign. Between 1 and 200 characters.
</ParamField>

<ParamField body="subject" type="string">
  Email subject line. Between 1 and 998 characters.
</ParamField>

<ParamField body="previewText" type="string">
  Preview text shown in email clients. Maximum 200 characters.
</ParamField>

<ParamField body="from" type="object">
  Sender identity to use for this campaign.

  <Expandable title="from">
    <ParamField body="from.email" type="string">
      Sender email address. Must be a valid email.
    </ParamField>

    <ParamField body="from.name" type="string">
      Sender display name. Maximum 200 characters.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="fromSenderId" type="string">
  id of a saved sender identity.
</ParamField>

<ParamField body="replyTo" type="string">
  Reply-to email address. Must be a valid email.
</ParamField>

<ParamField body="templateId" type="string">
  ID of the email template to use. The template can be created via the [Template API](/api-reference/templates/create). Either `templateId` or `htmlTemplate` is required.
</ParamField>

<ParamField body="htmlTemplate" type="string">
  Raw HTML content to use as the campaign email body. Either `htmlTemplate` or `templateId` is required. If both are provided, `htmlTemplate` takes precedence and the template referenced by `templateId` will be updated with the provided HTML content.
</ParamField>

<ParamField body="toLists" type="array">
  Array of list or segment IDs to send the campaign to.
</ParamField>

<ParamField body="excludeLists" type="array">
  Array of list or segment IDs to exclude from sending.
</ParamField>

<ParamField body="unsubscribeGroupId" type="string">
  ID of the unsubscribe group to associate with this campaign.
</ParamField>

<ParamField body="sendNow" type="boolean">
  If `true`, triggers sending immediately.
</ParamField>

<ParamField body="scheduledAt" type="string">
  ISO 8601 date-time string at which to schedule the campaign for sending.
</ParamField>

<ParamField body="sendToGlobalList" type="boolean">
  If `true`, send to all contacts in the global list.
</ParamField>

<ParamField body="publish" type="boolean">
  If `true`, publishes and finalizes the campaign.
</ParamField>

<ParamField body="trackingClick" type="boolean">
  Enable or disable click tracking.
</ParamField>

<ParamField body="trackingOpen" type="boolean">
  Enable or disable open tracking.
</ParamField>

<ParamField body="sendMode" type="string">
  Delivery mode. One of: `immediate`, `scheduled`, `gradual`.
</ParamField>

<ParamField body="gradualStrategy" type="string">
  Growth strategy for gradual sending. One of: `fixed`, `1.25x`, `1.5x`, `1.75x`, `2x`.
</ParamField>

<ParamField body="dailyBatchSize" type="integer">
  Number of emails to send per day in gradual mode. Must be at least `1`.
</ParamField>

<ParamField body="timezone" type="string">
  Timezone string for scheduled or gradual sending.
</ParamField>

### Response

<span className="text-sm">Returns the updated campaign object.</span>

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  The updated campaign object.

  <Expandable title="data">
    <ResponseField name="id" type="string">
      Unique identifier of the campaign.
    </ResponseField>

    <ResponseField name="name" type="string">
      Updated display name.
    </ResponseField>

    <ResponseField name="subject" type="string">
      Updated subject line.
    </ResponseField>

    <ResponseField name="previewText" type="string">
      Updated preview text.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status of the campaign.
    </ResponseField>

    <ResponseField name="sendMode" type="string">
      Delivery mode: `immediate`, `scheduled`, or `gradual`.
    </ResponseField>

    <ResponseField name="trackingClick" type="boolean">
      Whether click tracking is enabled.
    </ResponseField>

    <ResponseField name="trackingOpen" type="boolean">
      Whether open tracking is enabled.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp when the campaign was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 timestamp when the campaign was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml PATCH /campaigns/{campaignId}
openapi: 3.1.0
info:
  title: Autosend Campaigns API
  version: 1.0.0
  description: API endpoints for managing marketing campaigns in Autosend.
servers:
  - url: https://api.autosend.com/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /campaigns/{campaignId}:
    patch:
      summary: Update Campaign
      description: Updates fields on an existing campaign.
components: {}

````