How do I configure a webhook?

To configure a webhook, you must be an admin for your Bitly account.

For more detailed information about webhooks, visit What are webhooks?

To configure a webhook:

1. Log in to your Bitly account.
2. Click Settings in the left sidebar.
   
3. Under Account settings, click Webhooks.
   
4. Click Add webhook.
   
5. Add the required webhook endpoint information:
   1. Name: Be descriptive. For example, to add a record to a database application, you could call it "Add to BigDatabase." Or, if you're triggering a notification, "Send notification via CRM."
   2. Endpoint URL: Enter the URL where the payload will be sent. This can be found in the receiving application's settings.
   3. Select the group(s) that this webhook will apply to.
   4. Select the event that will trigger the webhook. "Engagements" is currently the only option. It includes all engagements for your selected group(s): Short Link clicks, QR Code scans, and Link-in-bio clicks.
   
6. To set the webhook to Active as soon as you complete this setup, check the Activate Immediately box.
7. To include tags in the webhook event payload, check the Fetch tags box. (Learn more about what information will be delivered by the webhook on our dev site.)
8. To integrate this webhook with an OAuth 2.0-compliant app, add the OAuth URL, Client ID, and Client secret.
   
9. Click Add Endpoint.

Your webhook will now be displayed in the Webhook settings. To deactivate, edit, or delete a webhook, click the three-dot menu at the end of the row. To add a new one, come back to this page at any time and click Add webhook.