Manage webhooks

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)
• 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)

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 — what each delivery contains.
• Security — why the secret key should never be empty in production.