---
title: "Manage webhooks"
description: "Set up, edit, and remove webhook configs from the Apps page in OnePageCRM — the fields each config takes and who can change them."
canonical_url: https://developer.onepagecrm.com/webhooks/manage/
source: Markdown mirror of https://developer.onepagecrm.com/webhooks/manage/
---

A webhook config is four fields: a name, a target URL, a format, and
a secret. You manage configs from the **Apps** page in OnePageCRM.

## In the app

An account **administrator** opens **Apps** in OnePageCRM and
activates the **Webhooks** app. From there you can add, edit, and
remove configs. Each one takes:

- **Name** — a label for you
- **Target URL** — where OnePageCRM POSTs; use HTTPS
- **Format** — `json` (see [Payloads](/webhooks/payloads/))
- **Secret key** — the form lets you leave this blank, but set one
  anyway; it's how your endpoint tells a genuine event from a forged
  one (see [Security](/webhooks/security/))

Only an administrator can activate the app or change its configs.

Adding a config starts delivery to that URL right away. Removing one
stops delivery to it immediately.

## Next

- [Payloads](/webhooks/payloads/) — what each delivery contains.
- [Security](/webhooks/security/) — why the secret key should never
  be empty in production.