You can subscribe to webhooks to receive notifications about particular events that happen in Perk. Once the specific event occurs, Perk sends a notification instantly to the chosen URL destination.
For example, you can rely on webhooks to trigger an action in your app when an invoice is issued to create an expense report in your expense management tool. With webhook subscriptions you can make fewer API calls or trigger real-time actions on your side.
Using this API, you can programmatically:
- List all existing webhooks
- List all events to which you can subscribe
- Subscribe to a particular event or list of events
- Edit a subscription
- Disable a subscription
- Delete a subscription
OAuth scopes required for the Webhooks API
To create or update webhooks, you need the corresponding scope. To call the list and retrieve webhooks endpoints, you can use any valid OAuth scope.
See the Webhooks guide for more information.
TipYou can also configure webhooks directly from the dashboard. The dashboard provides a user interface to create, edit, delete, disable, or test a webhook.