---
updatedAt: 2026-07-28T17:04:02.000Z
agentTools:
  projectIndex: https://dev.opendatalabs.com/llms.txt
---

# Getting Started

Make your first authenticated Open Data Labs API call from server-side code.

## What to do next

1. Create or select an app in your <a href="https://dashboard.opendatalabs.com/" target="_blank" rel="noreferrer">OpenDataLabs Dashboard</a>.
2. Add your app domain where you wish to launch a [Connect Session](https://dev.opendatalabs.com/reference/createconnectsession).
3. Call `POST /connect/sessions` from your server to start a [Connect Session](https://dev.opendatalabs.com/reference/createconnectsession) for a source.
4. You can also list available [Sources](https://dev.opendatalabs.com/reference/listsources) and their [Scopes](https://dev.opendatalabs.com/reference/listsourcescopes).

For a complete walkthrough, continue to the [Quickstart](https://dev.opendatalabs.com/docs/quickstart) and [integration guides](https://dev.opendatalabs.com/docs/integrating-connect-flow) in the main docs.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Open Data Labs API",
    "version": "v1",
    "description": "Server-side API for discovering sources and creating hosted Connect sessions."
  },
  "servers": [
    {
      "url": "https://api.opendatalabs.com/api/v1"
    }
  ],
  "tags": [
    {
      "name": "Sources",
      "description": "Discovery endpoints. Start here to confirm your API key works and to inspect available sources and scopes."
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "Pass an Open Data Labs API key for server-to-server requests."
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/sources": {
      "get": {
        "tags": [
          "Sources"
        ],
        "summary": "List available sources",
        "description": "Recommended first authenticated request. Use it to verify your API key and see which sources can be connected before creating a hosted Connect session.",
        "operationId": "listSources",
        "responses": {
          "200": {
            "description": "All supported sources.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "id",
                      "name",
                      "description",
                      "status",
                      "scopes"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "enum": [
                          "github",
                          "oura",
                          "instagram",
                          "icloud_notes",
                          "spotify"
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "available",
                          "coming_soon",
                          "beta"
                        ]
                      },
                      "scopes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "sources": {
                    "value": [
                      {
                        "id": "github",
                        "name": "GitHub",
                        "description": "Exports your GitHub profile, repositories, and starred repositories.",
                        "status": "available",
                        "scopes": [
                          "read:profile",
                          "read:repositories",
                          "read:starred"
                        ]
                      },
                      {
                        "id": "oura",
                        "name": "Oura Ring",
                        "description": "Exports your Oura Ring readiness scores, sleep data, and daily activity.",
                        "status": "available",
                        "scopes": [
                          "read:readiness",
                          "read:sleep",
                          "read:activity"
                        ]
                      },
                      {
                        "id": "instagram",
                        "name": "Instagram",
                        "description": "Exports your Instagram profile and posts.",
                        "status": "available",
                        "scopes": [
                          "read:profile",
                          "read:posts",
                          "read:following",
                          "read:ads"
                        ]
                      },
                      {
                        "id": "icloud_notes",
                        "name": "iCloud Notes",
                        "description": "Exports your Apple Notes and folders from iCloud.",
                        "status": "available",
                        "scopes": [
                          "read:notes",
                          "read:folders"
                        ]
                      },
                      {
                        "id": "spotify",
                        "name": "Spotify",
                        "description": "Exports your Spotify library, playlists, listening history, and preferences.",
                        "status": "coming_soon",
                        "scopes": [
                          "read:profile",
                          "read:savedTracks",
                          "read:playlists"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid bearer token.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error",
                    "message"
                  ],
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": "unauthorized",
                      "message": "Invalid or missing token"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```