---
title: "Update a webhook"
method: PUT
path: "/projects/{project_id}/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Update a webhook

`PUT /projects/{project_id}/webhooks/{webhook_id}`

Updates a configured webhook in the project. Requires *Manage settings* admin right.

Requires <code>write_webhooks</code> OAuth access scope.

## Path parameters

- `project_id` string, required
- `webhook_id` string, required

## Request body

- object
  - `url` string — Update the URL to your endpoint.
  - `branch` string — You can limit the usage of the webhook to a specific branch by specifying the name of the branch as a string. If you pass <code>null</code> or skip this attribute, the webhook will be applied to all branches.
  - `events` string[] — Update the list of subscribed events. Possible values are <code>project.imported</code>, <code>project.exported</code>, <code>project.deleted</code>, <code>project.snapshot</code>, <code>project.languages.added</code>, <code>project.language.removed </code>, <code>project.language.settings_changed</code>, <code>project.key.added</code>, <code>project.key.modified</code>, <code>project.keys.deleted</code>, <code>project.key.comment.added</code>, <code>project.translation.updated</code>, <code>project.translation.proofread</code>, <code>project.contributor.added</code>, <code>project.contributor.deleted</code>, <code>project.task.created</code>, <code>project.task.closed</code>, <code>project.task.deleted</code>, <code>project.task.language.closed</code>, <code>project.branch.added</code>, <code>project.branch.deleted</code>, <code>project.branch.merged</code>, <code>team.order.created</code>, <code>team.order.completed</code>, <code>team.order.deleted</code>.
  - `event_lang_map` object[] — Map the event with an array of languages iso codes. Omit this parameter for all languages in the project. Currently only <code>project.translation.updated</code> and <code>project.translation.proofread</code> events can be mapped with languages.
    - `event` string — Event name.
    - `lang_iso_codes` string[] — List of languages iso codes.

## Response `200`

OK

- object
  - `project_id` string
  - `translations` Webhooks
    - `webhook_id` string — A unique identifier of the webhook.
    - `url` string — Specified URL.
    - `branch` string — If webhook is limited to single branch.
    - `secret` string — <code>X-Secret</code> header sent with webhook requests.
    - `events` unknown[] — List of events webhook is subscribed to. See our <a href="https://docs.lokalise.com/en/articles/3184756-webhooks" target="_blank" rel="noopener noreferrer">documentation</a> for available events and payload examples.
      - unknown
    - `event_lang_map` object[] — List of maps with languages assigned to the events.
      - `event` string — Event name.
      - `lang_iso_codes` unknown[] — List of languages iso codes.
        - unknown

---

[API](https://skmtc.net/lokalise/apis/default-projects.md) · [All operations](https://skmtc.net/lokalise/apis/default-projects/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lokalise/default-projects/revisions/7bceba421b12/schema)