Connect Restream to OttoKit

The Restream API lets you integrate your systems with Restream, giving you the power to automate live streaming workflows, manage channels and events, and create custom solutions tailored to your broadcasting needs. With the Restream API, you can connect your existing tools to Restream to streamline multi-platform streaming, retrieve real-time data, and enhance your content distribution.

Prerequisites

Before you begin, make sure you have an active Restream account. If you don’t have one yet, sign up at restream.io — a Restream account is required to create an application.

Create an App

To create an app using the Restream API:

1. Log in to your Restream account and open the Applications page at developers.restream.io/apps.
2. Click the Create New button.
3. Enter a Display Name for your application (this will be shown to users when they authorize your app).
4. Upload an Avatar for your application (optional but recommended for a polished authorization screen).
5. Click Create to save your application.

Once the app is created, you will be redirected to the app settings page where you can configure the remaining OAuth details.

Copy your Client ID and Client Secret

On the app settings page you will find two important credentials:

• Client ID — a unique public identifier for your app. Click the copy button next to it to copy.
• Client Secret — a private key used to authenticate your app. It is hidden by default. Click on the masked field to reveal it, then use the copy button to copy.

Important: Do not share your credentials with anyone to keep your access token secure. If your Client Secret is ever compromised, click the Regenerate link to create a new one. Note that your app will stop working until you update the secret in OttoKit.

Add the OAuth2 Redirect URI

Under the Redirect URI’s section of your Restream app settings, add the callback URL that OttoKit provides. This is required for the OAuth2 flow.

Paste the following URL into the Redirect URI input field:

https://api.ottokit.com/restream/connection

What is an OAuth2 Redirect URI?

Restream follows the OAuth2 protocol for security purposes. The Redirect URI (the web address you enter) is where users will be sent after they authorize your app, and it keeps the access token secure during the handshake. You can add multiple redirect URIs by clicking Add another if needed.

Select Scopes

Under the Scopes section, check the permissions your application will need through OttoKit. Only select the scopes your integration actually requires — for example:

• profile.default.read — read the user’s profile details
• channel.default.read — list and read connected channels
• channel.default.write — add or remove channels
• stream.default.read — read stream keys and streaming info
• chat.default.read / chat.default.write — read and send chat messages

Info: Changing scopes after users have already authorized your app may require them to re-authenticate.

Connect Restream in OttoKit

Once your Restream app is ready:

1. In OttoKit, open the Restream integration and choose Add Connection.
2. Paste the Client ID and Client Secret you copied from the Restream app settings.
3. Click Authorize — you will be redirected to Restream to approve the requested scopes.
4. After approving, you’ll be returned to OttoKit and your Restream connection will be ready to use in workflows.

API Calls on Restream

Important: Restream applies rate limits to active API keys to maintain service quality for all users. If your app exceeds the allowed rate, the request may return an error response — OttoKit will automatically retry supported requests after a short delay.