---
title: "Set up webhook configuration"
method: POST
path: "/webhooks"
tags: ["Webhook API"]
---

# Set up webhook configuration

`POST /webhooks`

Use this endpoint to enable a webhook URL for a store and select webhook event types that will be sent to this URL.

 Note that only one webhook URL can be active for a store, so calling this method disables all existing webhook configuration.

 Setting up the [Stock updated](#operation/stockUpdated) webhook requires passing IDs for products that need to be monitored for changes. Stock update webhook will only include information for specified products. These product IDs need to be set up using the params property.

## Headers

- `X-PF-Store-Id` string

## Request body

- object
  - `url` string, required — Webhook URL that will receive store's event notifications
  - `types` string[], required — Array of enabled webhook event types
  - `params` object

## Response `200`

OK

- object
  - `code` integer — Response status code `200`
  - `result` WebhookInfo
    - `url` string — Webhook URL that will receive store's event notifications
    - `types` string[] — Array of enabled webhook event types
    - `params` object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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