Connectors / Service / Bevy

Bevy

Bevy

Bevy is a community event engine fuelling virtual, hybrid, and in-person events.

Overview

Bevy is purpose-built to help companies build, grow and scale their global communities and to help local communities of passionate advocates make a positive impact on the world. C2C Marketing empowers your greatest ambassadors, your customers, to evangelize on behalf of your brand and grow your community.

API INFO: The Base URL used for the Bevy connector is https://<your Bevy domain>. More information can be found on their main API documentation (v1.0) site. This is where users will also be able to find the API Limitations page.

Authentication

Within the workflow builder, highlight the Bevy connector.

In the Bevy connector properties panel to the right of the builder, click on the Authenticate tab and the 'New authentication' button. This will result in a Tray.io authentication pop-up modal.

Name the authentication something that will easily identify it in a larger list. For example using the name of the service account, whether it is a Sandbox or Production OAuth, etc.

When choosing between the type of authentication you wish to create ('Personal' or 'Organisational'), consider who and how many people will need access to it.

The second page asks you for your 'Domain' and 'API Key' credentials.

In order to get these fields, head to your Bevy instance dashboard. Your domain is the address that appears in your browser's address bar. In this example, it's 'demo3.bevylabs.com'.

IMPORTANT!: do not include 'https://' in the domain

To find your API Key, click on your profile icon and then click 'profile' to visit your profile page.

From your profile page, you can click on 'API Key' to display the API Key.

Once you have added these fields to your Tray.io authentication pop-up window, click the 'Create authentication' button.

Go back to your settings authentication field (within the workflow builder properties panel), and select the recently added authentication from the dropdown options now available.

Your connector authentication setup should now be complete.

Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Using the Raw HTTP Request ('Universal Operation')

As of version 1.0, you can effectively create your own operations.

This is a very powerful feature which you can put to use when there is an endpoint in Bevy which is not used by any of our operations.

To use this you will first of all need to research the endpoint in the Bevy API documentation v1.0, to find the exact format that Bevy will be expecting the endpoint to be passed in.

Note that you will only need to add the suffix to the endpoint, as the base URL will be automatically set (the base URL is picked up from the value you entered when you created your authentication).

For example, say that the 'List Chapters' operation did not exist in our Bevy connector, and you wanted to use this endpoint. You would use the Bevy API docs to find the relevant endpoint - which in this case is a GET request called: /api/chapter.

More details about this endpoint can be found here.

As you can see there is also the option to include a query parameter, should you wish to do so. So if you know what your method, endpoint, and details of your query parameters are, you can list all the chapters and use the 'fields' parameter to return only their titles with the following settings:

Method: GET

Endpoint: /api/chapter

Query Parameter: Key: fields Value: title

Final outcome being: https:://example-domain.bevy.com/api/chapter?fields=title

All Operations

Latest version:

1.1