---
title: "Generate a test webhook"
method: POST
path: "/webhooks/send"
tags: ["webhooks"]
---

# Generate a test webhook

`POST /webhooks/send`

Generates a test Webhook.

> **Important:** This operation uses server `https://brandfolder.com/api/v1` (notice the version is `v1`).

> **Important:** Ensure that your code is able to receive a Brandfolder
Webhook using this endpoint before creating a production Webhook
subscription.

If you receive a `202` response at this endpoint, then a fake Webhook
notification will POST to your `callback_url`. If you don't receive anything
at your `callback_url` within a few minutes, it is likely that
`callback_url` is invalid. Please ensure the URL begins with `https://` and
that it is a public domain (not `localhost`, behind a firewall, or any other
domain requiring authentication) which can receive HTTP `POST` requests and
respond with a `2xx` HTTP status code.

## Request body

- object
  - `data` object, required
    - `attributes` object, required
      - `event_type` 'asset.create' | 'asset.update' | 'asset.delete', required — Event type.
      - `resource_key` string, required — Brandfolder ID.
      - `resource_type` 'brandfolder', required — The type of resource the event acts on. Currently, `brandfolder` is the only supported type.
      - `callback_url` string, required — An HTTPS URL where webhook data will be posted. Please ensure the URL begins with `https://` and that it is a public domain (not `localhost`, behind a firewall, or any other domain requiring authentication) which can receive HTTP `POST` requests and respond with a `2xx` HTTP status code.
      - `asset_key` string — Asset ID override
      - `organization_key` string — organization ID override.

## Response `202`

The webhook was successfully created.

- object
  - `message` string
  - `status` string

## Other responses

- `400` — Invalid Payload Provided
- `403` — Permission Denied for Provided Resource
- `404` — Provided Resource Does Not Exist
- `409` — Subscription Already Exists
- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)