Build on megastream, the right way

Our official OAuth API lets approved third-party apps work with megastream on behalf of users who connect their account. It is the one and only supported way to integrate with megastream.

What the API offers

OAuth 2.0 sign-in

Users connect their account to your app themselves and can disconnect it at any time. Passwords never change hands.

Contact management

Manage the signed-in user's contacts from your logger, app or service, and nobody else's.

Strictly scoped access

Your app gets only the permissions the user approves, for that user's own account, and nothing more.

Cards on megastream

Show connected users a card with their own data from your service, right here on our pages.

Your app, on megastream

Approved apps can show a card in the side columns of our pages to users who have connected them: a summary of their account with you, their recent activity, whatever your service does best. Every card is labelled with your app's name and logo, so users know exactly where it comes from.

  • You describe the card in JSON using the open Adaptive Cards format. We draw it in our own style, so it always fits the page.
  • Our server asks yours for the card with a signed request naming the user, so you only ever show their own data.
  • Text, facts, columns, images and link buttons back to your service. Nothing you send runs on our pages.
  • Cards are enabled per app, as part of approval. Preview yours from My Apps at any time.
Your activity this week
Items
24
Last synced
Today, 18:40
Status
Up to date
All caught up
Open your app
From Your App

An example card, as users would see it.

How approval works

  1. Submit your application Create an app and tell us what it does, who it is for and exactly why it needs access. You need a verified email address and an account at least 30 days old.
  2. We review it A real person checks every app before it can connect to anyone's account. We will say no if we are not satisfied.
  3. Get your credentials Approved apps get their client details and API documentation on the My Apps page. Access can be revoked at any time if the rules are broken.

Quality over quantity

This API is for serious, professional integrations with properly built and maintained systems. We look for developers who understand the technology behind their app, can keep it secure and will support it for the long term.

Apps put together with AI tools by someone without that understanding are unlikely to be approved. AI is a fine tool in the hands of an experienced developer, but it is no substitute for knowing how your app handles our users' data, how it stores their credentials and what happens when something goes wrong.

Your client secret and the access and refresh tokens we issue for each user are keys to their account. We expect them to be kept on your server only, encrypted at rest, never written to logs and never exposed in a browser, a downloadable app or a code repository.

Nothing personal. Our users trust us with their data, and protecting their privacy comes before everything else. If you're building something solid and you play by the rules, we look forward to seeing it.


The rules

The official API is the only integration we permit. The following are not supported or permitted under any circumstances.

  1. No other APIs. Do not use any other API, endpoint or unofficial method to access megastream.
  2. No scraping. Do not scrape, crawl or harvest data of any kind from this website or any associated systems, whether by bots, scripts or any other automated means.
  3. No form submissions. Do not have your app, script or bot submit any form on this website. That includes logging in, uploading data, submitting logs or anything of the kind.
  4. No pretending to be us. You are welcome to say in plain words that your app works with megastream, for example "Connect your megastream account". You must not use our logo or branding, put "megastream" in your app's name, or present your app as official or as made, endorsed or approved by megastream.

Breaking any of these rules results in a permanent block, including your applications and any IP addresses associated with them. There are no warnings and no second chances.

News RSS feed

Our latest news is available now as an RSS feed, with no sign-up needed: https://megastream.hamaward.com/news/feed

The feed is intended for personal use, not distribution. It is free to use for non-commercial purposes only, and you may not display it anywhere that solicits donations, payment or subscriptions of any kind, either directly or indirectly.

Our news is also available through the official API, under that API's terms and conditions. If you want to display our news in your app or website, you must use the official API and nothing else.