Skip to main content
POST
/
integration
/
spiideo
/
v1
/
integrations
cURL
curl --request POST \
  --url https://api.mottostreaming.com/integration/spiideo/v1/integrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "project_id": "<string>",
  "account_id": "<string>",
  "user_id": "<string>",
  "client_id": "<string>",
  "client_secret": "<string>",
  "default_minutes_before_start": "<string>",
  "default_duration_minutes": "<string>",
  "default_spiideo_sport": "<string>",
  "sync_teams": true,
  "locale": "<string>",
  "enabled": true,
  "share_with_account_ids": [
    "<string>"
  ],
  "stream_unlisted_events": true,
  "schedule_ahead_days": "<string>"
}'
{
  "integration": {
    "project_id": "<string>",
    "account_id": "<string>",
    "user_id": "<string>",
    "client_id": "<string>",
    "client_secret": "<string>",
    "default_minutes_before_start": "<string>",
    "default_duration_minutes": "<string>",
    "default_spiideo_sport": "<string>",
    "sync_teams": true,
    "locale": "<string>",
    "enabled": true,
    "share_with_account_ids": [
      "<string>"
    ],
    "stream_unlisted_events": true,
    "schedule_ahead_days": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

SpiideoIntegration

project_id
string
required

The Motto project to which this integration belongs

account_id
string
required

The Spiideo account ID.

user_id
string
required

The Spiideo user ID.

client_id
string
required

The Spiideo client ID.

client_secret
string
required

The Spiideo client secret.

default_minutes_before_start
string

The default number of minutes before the start of a game to turn on the camera. If not set, a default value will be used.

default_duration_minutes
string

The default duration in minutes for which the camera should be on. If not set, a default value will be used.

default_spiideo_sport
string

The default Spiideo sport to use when creating games. This should match the enum values in Spiideo, e.g. "football", "basketball", etc. This is used when the sport cannot be determined from the event type (via the event type mapping).

sync_teams
boolean

Whether to create teams in Spiideo based on Motto teams if they do not exist, or update them if they do. If false, you must manually provide the mapping between Motto teams and Spiideo teams, and keep it up to date. In this case, when trying to create a Spiideo game and there is no mapping for a team, the operation will fail. Defaults to false.

locale
string

The locale you would like to use for the objects being created in Spiideo. You must make sure this locale is also supported within your existing Motto project (on events, teams and players). If it does not, it will fallback to non-localized values.

The format should be the language code, e.g. "en", "de", "fr", etc, optionally followed by a region code, e.g. "en-US", "en-GB", etc.

enabled
boolean

Whether the integration is enabled. If false, no Spiideo-related operations will be performed. You can still create entity mappings and update event type mappings, but they will not be used until the integration is enabled.

share_with_account_ids
string[]

When a game is created, it can be shared with other accounts in Spiideo automatically. This field contains the list of account IDs with which the game should be shared.

stream_unlisted_events
boolean

Whether to stream unlisted events in Spiideo. If false, unlisted events will be not be connected to Spiideo, and events that were previously published will be deleted from Spiideo once they become unlisted. Defaults to false.

schedule_ahead_days
string

The number of days to look forwards in time to schedule games in Spiideo. For example, if this is set to 7, the integration will only schedule Motto events in Spiideo that are happening within the next 7 days. If it's further out, the integration will not schedule them until they are within the next 7 days. If not set, a reasonable default amount of days will be used.

Response

OK

integration
object

SpiideoIntegration

I