Announcing Nylas Event Metadata

Increase calendar visibility by using metadata to tag and filter events based on key values like project names and teams.

Dominic Corsaro | March 31, 2021

The Nylas Calendar API enhances your platform with productivity-boosting features such as the Availability and Consecutive Availability endpoints. We are excited to announce a new feature that exposes valuable insights from the events your application manages: Event Metadata.  By leveraging metadata, you can track product adoption by tagging events created through your platform and events added externally. Additionally, your users can have greater visibility into calendar activities by tagging and filtering events based on key values such as project names, attending teams, and categories.

Your Product and Engineering Teams Lack Visibility Into Events

You and your users need more insight into the events your application manages. You want your application to be the central scheduling hub for your users and need better visibility into product adoption. Your users want to extract information from calendars to drive growth. While metadata can help guide both business strategies, building a solution in-house is time-consuming and costly. You need an agnostic solution that is compatible with a variety of calendar providers as they all have different metadata parameters. You also need a team to build and maintain a metadata solution that supplies and applies key values to events, a filtering mechanism, and a method to combine the event values provided through your calendar integration.

Want a PDF of this article?

Share it with a friend or save it for later reading.

Capture Valuable Data to Drive Strategy

Leveraging metadata empowers your users with additional insights that help shape and inform strategic decisions. You can define custom values that are use case specific and enhance visibility into the events your users’ teams create and attend. Metadata also provides valuable information about your users’ activity and product adoption. By defining values, you can highlight which events are created and get direct insight into your user base to inform decisions that drive growth.

How Nylas Event Metadata Works

Once you integrate your application’s calendar using the Nylas Calendar API, you can use the /events endpoint to create metadata parameters.  You can make a POST request to the /events endpoint to create parameters and a PUT request to update or delete the metadata parameters. Nylas supports exact match search for filtering, and you can search and filter with a GET request using the specific key values.

Here is an example code using metadata to show an event created in your application using Nylas:

curl - X POST https://api.nylas.com/events
{
    "title": "On-site Consultation",
    "description": "Let's do some on site testing of our latest spacefaring ornithopters.",
    "metadata": {
      "custom_id": "my_custom_id",
      "event_type": "nylas"
    }
    "location": "The Launch Pad",
    "when": {
        "object": "date",
        "date": "2145-02-13"
    }
    "participants": [
        {
            "comment": null,
            "name": "Katherine Johnson",
            "email": "[email protected]",
            "status": "confirmed"
        },
        {
            "comment": null,
            "name": "Leonardo Da Vinci",
            "email": "[email protected]",
            "status": "confirmed"
        }
    ],
}

Here are generic metadata code examples showing different options you can set up for your application

Tags
"metadata": {
         "tag" : "" # Finite set of possible tag strings
}

Project Names
"metadata": {
         "project_name" : "" # Finite set of possible tag strings
}

Event Categories
"metadata": {
         "event_category" : "" # Finite set of possible tag strings
}

Learn more about the Nylas Event Metadata in our docs here.

Event Metadata Use Cases

Event Metadata can help guide decisions for both you and your users. Regardless of the industry you serve, you can use metadata to inform and influence strategy while offering a clearer picture of the events your application manages.

Here are a few examples below:

  • General Use Case: Categorize and filter meetings based on metadata information. Leverage Event Metadata to get a simple calendar view showing meetings occurring for a particular project. By defining key values in metadata parameters, you can offer robust management solutions that provide visibility into which meetings different teams are attending to ensure everyone’s time is being used efficiently.

  • Professional Services: Use metadata to see if users are scheduling appointments through your application or booking appointments independently. Leverage this information to help guide users back to your platform to schedule meetings, while helping to increase retention and engagement on the platform.

Unlock Valuable Information with Event Metadata

Offering deeper insight into the events your application manages unlocks valuable insight that drives strategic decisions and business growth for you and your end users. We are excited to continue our expansion of the Nylas Calendar API’s capabilities and offer this to our customers.

Speak to a Nylas Platform Specialist now to learn more and get access to the Event Metadata.

Dominic Corsaro

Dominic is a Product Marketing Manager at Nylas. In his spare time, he loves to hike and go to the beach with his dog.