---
title: "Set project environment webhook"
method: PUT
path: "/v1/connect/{project_id}/webhook"
---

# Set project environment webhook

`PUT /v1/connect/{project_id}/webhook`

Create or update the webhook URL for a project environment. Creating a webhook returns `signing_key`; updating an existing webhook does not.

## Headers

- `x-pd-environment` 'development' | 'production', required — The environment in which the server client is running

## Request body

- SetWebhookOpts — Request options for setting a webhook URL
  - `url` string, uri, required — The webhook URL to set

## Response `200`

webhook updated

- SetWebhookResponse — Response received when creating or updating a webhook
  - `data` WebhookWithOptionalSigningKey, required — A webhook object that may include the signing key. The signing key is returned when a webhook is created, but omitted when an existing webhook is updated.
    - `id` string, required — The unique ID of the webhook
    - `url` string, uri, required — The webhook URL
    - `signing_key` string — The webhook signing key, when returned by the endpoint
    - `signing_key_set` boolean, required — Whether a signing key has been set for this webhook
    - `created_at` integer, required — The time the webhook was created, in epoch seconds
    - `updated_at` integer, required — The time the webhook was last updated, in epoch seconds

## Other responses

- `429` — too many requests

---

[API](https://skmtc.net/pipedream/apis/pipedream-rest-api.md) · [All operations](https://skmtc.net/pipedream/apis/pipedream-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedream/pipedream-rest-api/revisions/c25dbf225c49/schema)