Rate this page:

The Plugins API

The Plugins API defines which plugins the Flex UI will load during initialization. Flex Plugins are bundled JavaScript or TypeScript customizations that change the presentation and behavior of the Flex UI.

The Plugins API is used by the Flex Plugin CLI and the Plugins Dashboard to simplify common workflows like:

  1. Defining a plugin and each incremental version that you develop
  2. Control which plugins are enabled for your agents
  3. Track your version and release history as you update Flex
  4. Quickly revert to a previously known working configuration when troubleshooting agent issues


A Release enables your plugin configuration. Only one release can be active within your account.

A Configuration contains the collection of plugin versions that you want to roll out to your contact center.

A Plugin Version contains all the information about a particular version of a plugin: the link to the plugin package, the version number, and which plugin it relates to. Plugin Versions can be hosted on Twilio Assets or at any other destination you prefer.

A Plugin contains information about a plugin, like its name and description.

The diagram below shows the relationship between each of the resources mentioned above:

A diagram of the various resources in the plugins api

Next Steps

While it's useful to know about the Plugins API for advanced use cases, the Flex Plugins CLI makes it a lot easier to interact with it. Head over to the Flex Plugins CLI docs to learn more. If you would rather use a UI to manage your plugins, refer to the Plugins Dashboard usage guide to get started.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more