Onboarding for Sports Leagues

This guide explains what’s required to fully integrate your events with our platform and launch your Add to Calendar experience for fans.


1. Providing Your Data Feed

The first step is supplying Stanza with a structured feed of your events. For example, a league might provide:

  • Full season schedule (e.g., Serie A 2025/26)

  • Cup or tournament schedule (e.g., Coppa Italia)

Feed Requirements

Your feed should include the following fields for each event:

  • Event Name – e.g., “AC Milan vs Juventus”

  • Date – YYYY-MM-DD format

  • Time – HH:MM format (24h preferred)

  • Timezone – Clearly specified (UTC offset or IANA format like Europe/Rome)

  • Location – Stadium name, city

  • Unique Match ID – Stable identifier for each game (helps with updates)

⚠️ The more complete the feed, the better. Optional fields like broadcaster, round number, or match stage (e.g., “Quarterfinal”) are also welcome.


2. Stanza Integration

Once we receive your feed, our team integrates it into Stanza. This process includes:

  • Validating data quality and format

  • Setting up automated updates from your feed

  • Mapping matches to existing clubs and competitions in Stanza

If you already have teams or competitions live on Stanza, we’ll link your feed so data stays consistent across all calendars.


3. Add to Calendar Pages

We’ll create Add to Calendar pages for your fans, such as:

  • By club – Fans can subscribe to their favorite team’s matches only (e.g., AC Milan’s schedule)

  • By competition – Fans can follow tournaments like Coppa Italia independently

These pages are hosted by Stanza and optimized for fan adoption across devices.


4. League & Team Pages

If you are a league with teams already on Stanza, we’ll coordinate to avoid duplicate calendars.

  • Leagues should add their Add to Calendar button to the official league website.

  • Teams should continue to use their existing Add to Calendar pages.

  • This ensures fans don’t see multiple overlapping calendars and prevents confusion.


5. What’s Required from You

To launch your Add to Calendar experience, we’ll need:

  1. Data feed access (as described in Section 1)

  2. Confirmation of competitions and team breakdowns (so we set up the right pages)

  3. Placement on your website – Refer to Share your Calendar to add the Stanza “Add to Calendar” button to your official site and apps, so fans can easily discover it

That’s it! Stanza handles everything else — from integration and hosting to updates and fan support.


6. Timeline

A typical integration looks like this:

  1. Week 1 – You provide your feed

  2. Week 2-4*** – Stanza integrates feed + QA

  3. Go Live – Add to Calendar pages go live

  4. Ongoing – Automatic updates from your feed keep calendars accurate

** Integrations typically take 1–2 weeks. Complex APIs may extend that timeline.


7. Support

If you have technical questions or would like us to review your feed format before sending it, contact our team at founders@stanza.co


Frequently Asked Questions

Can we send score updates?

Yes. We can include final score in the event title or description, or in custom fields.

What about TBD games or competitors?

Send a placeholder time and flag status: postponed or include start.time: "TBD"; we’ll handle fan messaging and later updates.

Can we process multiple competitions from one feed?

Yes—use competition.name (or something similar) per event; we’ll route each to the correct calendar.

Logo hosting?

You can host and provide URLs for teams and competitions.

Last updated