---
title: "Edit a Campaign"
method: POST
path: "/v2/campaigns/update"
tags: ["Campaigns"]
---

# Edit a Campaign

`POST /v2/campaigns/update`

Edit an existing campaign. The fields required depend on the value of the `action` parameter:

<table>
  <colgroup>
    <col style="width: 22%">
    <col style="width: 22%">
    <col style="width: 56%">
  </colgroup>
  <thead>
    <tr><th>Action</th><th>Required Additional Fields</th><th>Optional Additional Fields</th></tr>
  </thead>
  <tbody>
    <tr><td><code>update-settings</code></td><td><em>(none)</em></td><td><code>name</code>, <code>size</code>, <code>radius</code>, <code>measurement</code>, <code>ai_analysis</code>, <code>keyword_type</code>, <code>date</code>, <code>time</code>, <code>frequency</code>, <code>notify</code>, <code>email_name</code>, <code>email_replyto</code>, <code>email_subject</code>, <code>email_body</code>, <code>recipients</code>, <code>email_send_ai</code></td></tr>
    <tr><td><code>add-location</code></td><td><code>place_id</code></td><td><code>size</code>, <code>radius</code>, <code>measurement</code>, <code>platforms</code></td></tr>
    <tr><td><code>modify-location</code></td><td><code>place_id</code></td><td><code>size</code>, <code>radius</code>, <code>measurement</code>, <code>platforms</code></td></tr>
    <tr><td><code>remove-location</code></td><td><code>place_id</code></td><td><em>(none)</em></td></tr>
    <tr><td><code>add-keyword</code></td><td><code>keyword</code></td><td><code>place_id</code>, <code>keyword_type</code></td></tr>
    <tr><td><code>update-keyword</code></td><td><code>keyword</code></td><td><code>place_id</code>, <code>keyword_type</code></td></tr>
    <tr><td><code>remove-keyword</code></td><td><code>keyword</code></td><td><em>(none)</em></td></tr>
  </tbody>
</table>

Many fields accept either a single value or a comma-delimited list of values (for example `place_id`, `keyword`, `platforms`).

A campaign cannot be modified while it is currently running — wait until the run finishes before calling this endpoint.

## Response `200`

Campaign updated successfully.

## Other responses

- `400` — The request was malformed or missing required parameters.
- `401` — The API key is missing, invalid, or does not have permission for the requested resource.
- `403` — Forbidden — campaign is currently running, or a referenced `place_id` has not been saved to the user's account.
- `404` — The requested resource could not be found.
- `429` — You have exceeded the rate limit. Please wait before making additional requests.
- `500` — An unexpected error occurred on the server. Please try again later.

---

[API](https://skmtc.net/localfalcon/apis/local-falcon-api.md) · [All operations](https://skmtc.net/localfalcon/apis/local-falcon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/localfalcon/local-falcon-api/revisions/06b5d428ba9e/schema)