Managing Webhooks & Subscriptions¶
Creating & Changing Webhooks¶
In order to change webhook URLs, you must delete your existing webhook and then create a new one. Note that when you do this, you will be required to re-add the appropriate user subscriptions to the new webhook.
| Create new webhook configuration | POST account_activity/webhooks |
| Retreive the apps current webhook configuration | GET account_activity/webhooks |
| Delete the app’s current webhook configuration | DELETE account_activity/webhooks/:webhook_id |
| Manually trigger a CRC request | PUT account_activity/webhooks/:webhook_id |
Why can’t I just update the URL?¶
Why are webhook configurations immutable? Twitter takes security very seriously. If your webhook URL is changed, there is a possibility that your application consumer key and consumer secret have been compromised. By requiring you to create a new webhook configuration, you are also required to re-subscribe to your user’s events. This requires the use of access tokens that a malicious party is less likely to posses. As a result, the likelihood that another party will receive your user’s private information is reduced.
Adding & Removing User Subscriptions¶
During the beta, access to the API is provided up to 50 account subscriptions per webhook and up to one webhook per Twitter application. If you have a need for access beyond these levels, please let us know by providing more information using this form.
| Add new user subscribtion | POST account_activity/webhooks/:webhook_id/subscriptions |
| Retreive a user subscription | GET account_activity/webhooks/:webhook_id/subscriptions |
| Remove a user subscription | DELETE account_activity/webhooks/:webhook_id/subscriptions |