Build for free
Announcing Nylas Event Metadata

Announcing Nylas Event Metadata

• 4 min read
Jump to section
    Author: Dominic Corsaro
    Dominic Corsaro
    Tags:
    Featured articles
    ExtractAI
    Introducing Nylas ExtractAI: Sync, filter, and extract structured data from your user’s inbox
    • 8 min read
    Read more
    API v3 Calendar API Scheduler
    Introducing the new Nylas Scheduler: Experience the future of in-app scheduling
    • 4 min read
    Read more
    AI Scheduling automation
    Automation is AI. How to prioritize user value over AI hype.
    • 8 min read
    Read more
    Jump to section

    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.

    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.

    Related resources

    Scheduling Smart Web Components
    Beyond APIs: Designing elegant, smart Web Components

    Dive into the world of smart Web Components for advanced API integration solutions. Design elegant, customizable elements to elevate user experiences.

    • 11 min read
    Read more
    Email API Salesforce
    Integrate customer communications in Salesforce with the Nylas Apex SDK

    The Nylas Apex SDK gives systems integrators a toolkit to develop email, calendar, and contacts integrations in Salesforce fast.

    • 5 min read
    Read more
    ExtractAI
    Introducing Nylas ExtractAI: Sync, filter, and extract structured data from your user’s inbox

    Nylas ExtractAI launches today for e-Commerce extraction in five markets, with support for over 30,000+ e-commerce merchants.

    • 8 min read
    Read more