---
title: "Create or update the enrichment endpoint"
method: PUT
path: "/v1/brands/{brandId}/enrichment"
tags: ["enrichment"]
---

# Create or update the enrichment endpoint

`PUT /v1/brands/{brandId}/enrichment`

## Request

- Base URL: `https://api.dispatchtickets.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dispatchtickets.com/v1/brands/{brandId}/enrichment`
- Auth: HTTP bearer

## Path parameters

- `brandId` string, required

## Request body

- UpsertEnrichmentDto
  - `url` string, required
  - `secret` string: HMAC-SHA256 signing secret. Omit to keep the existing secret, or to have one generated on first save.
  - `enabled` boolean
  - `events` string[]: Which events trigger a fetch. One or more of: ticket.created, ticket.opened
  - `timeoutMs` number: Request budget in milliseconds. Hard-capped at 2000ms server-side.

## Other responses

- `403`: Owners and admins only

---

[API](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api.md) · [All operations](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/revisions/529e6717d295?raw)