Skip to main content

Webhooks Enablement

Our webhooks functionality is finally available! On this page we'll explain how you can activate this new feature to start receiving events from Fatture in Cloud.

🅱️  Beta Phase​

The Webhooks are still in a Closed Beta version, this means that you can start using them only if we explicitly authorize you. If you try to create a subscription without prior authorization, your requests will always result in an error.

In this phase, errors could still arise and some events could still be missing; this means that you must consider this possibility while developing your application. We'll authorize just a limited set of users who are willing to help us test the application, and we kindly ask you to send us feedback if you notice unexpected behaviors.

🏢  The Company​

The authorization will be applied at Company level: this means that every app owned by an authorized company will be able to create a new Subscription using the dedicated endpoint. Even if a company is not directly authorized, if the webhooks are enabled for the app you're using to create the subscription (e.g. if the owner of the app is enabled) then you'll still be able to create a new subscription.

For example, let's suppose we have two apps:

  • App 1111, owned by company 222222
  • App 9999, owned by company 888888

We want to subscribe to the events of company 555555 by using one of the two apps. At this moment, only company 222222 has the Webhooks functionality enabled (this means 555555 and 888888 are not enabled yet).

In this scenario, we'll be able to create a new subscription for 555555 using app 1111 (because the owner 222222 is authorized), but not using app 9999 (because the owner 888888 is not authorized). This won't change even if 555555 itself is authorized, because it's the owner of the application that must be enabled, not the final user. To be able to create a subscription for app 9999, its owner 888888 must be enabled as explained below.

Please, notice that we will not authorize multiple companies for a single integration! If you're using a different company as a development or staging environment to test your code, we will not authorize your request on this fake company. We suggest requiring approval for a single company, and eventually creating different apps for every environment using this same company: since the webhooks are enabled on this company, all the owned apps will be able to use it. Once your company is authorized to use webhooks, you'll be able to use it with your other companies by filling out the app whitelist or by turning the app public (check the App Visibility section for more details).

This is true until the end of the Beta Phase, so in the future this block will be removed or modified.

🙋‍♂️  How can I apply?​

If you are interested in helping us test this functionality, you can apply by compiling this Google Form. Our API team will take care of it as soon as possible and we'll notify you via email.

➡️  What's next?​

Once your company has been enabled, feel free to start creating subscriptions!