API Quickstart

This guide walks you through creating an API key and making your first request. By the end, you’ll have successfully called the SkipUp API.

1. Create an API key

1. Go to your SkipUp workspace Settings
2. Click API Keys in the sidebar
3. Click Create API Key
4. Give the key a name (e.g., “My first key”)
5. Select the scopes you need — for this quickstart, choose meeting_requests.read
6. Click Create

Note

Your API key is only shown once. Copy it immediately and store it somewhere safe. If you lose it, you’ll need to create a new one.

Your key looks like this:

sk_live_abc123...

2. Set your API key

Store the key in an environment variable so you can use it in requests:

export SKIPUP_API_KEY="sk_live_your_key_here"

3. Make your first request

List the meeting requests in your workspace:

curl https://api.skipup.ai/api/v1/meeting_requests \
  -H "Authorization: Bearer $SKIPUP_API_KEY"

4. See the response

You’ll get back a JSON response like this:

{
  "data": [
    {
      "id": "mr_01H...",
      "organizer_email": "[email protected]",
      "participant_emails": ["[email protected]"],
      "status": "active",
      "title": "1:1 sync",
      "duration_minutes": 30,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "limit": 25,
    "has_more": false
  }
}

If your workspace has no meeting requests yet, data will be an empty array — that’s expected.

5. Try a filtered request

You can add query parameters to narrow results. For example, fetch only the first 5 meeting requests:

curl "https://api.skipup.ai/api/v1/meeting_requests?limit=5" \
  -H "Authorization: Bearer $SKIPUP_API_KEY"

What’s next

Now that you’ve made your first request, explore the full API:

• Authentication — Learn about scopes, key rotation, and security best practices
• Meeting Requests — Create and manage meeting requests
• Webhooks — Get notified when events happen in your workspace
• Workspace Members — Manage members programmatically

Tip

All list endpoints support cursor-based pagination. Pass limit to control page size (max 100) and cursor to fetch the next page. The response meta tells you if there are more results.