Get started¶

This page walks you through making your first authenticated request to the PlusPlus Public API.

1. Find your tenant subdomain¶

Every API request is scoped to a tenant — your PlusPlus instance. Your tenant subdomain is the part before .plusplus.app in the URL you use to access PlusPlus. For example, if you sign in at https://acme.plusplus.app/, your tenant is acme and the API base URL is:

https://acme.plusplus.app/public_api/v2

2. Create an API token¶

API tokens are created from your PlusPlus account settings. You must be an admin to create or revoke tokens.

1. Sign in to PlusPlus and open Settings → API tokens.
2. Click Create token, give it a description, and confirm.
3. Copy the token shown on the success screen. PlusPlus stores only a hash — once you leave this screen, the raw token cannot be recovered. Store it in a secret manager.

Tokens are prefixed with pp_ so they're easy to spot in logs.

3. Make your first request¶

List the users in your tenant:

curl https://acme.plusplus.app/public_api/v2/users \
  -H "Authorization: Bearer pp_your_token_here" \
  -H "Accept: application/json"

A successful response looks like:

{
  "data": [
    {
      "public_id": "01HXY8C5FZ7N4S0M2D3J6Q7K9P",
      "email": "jane.doe@acme.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "is_active": true
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 25,
    "total_count": 1,
    "total_pages": 1
  }
}

If the request fails, see Errors.

4. Where next¶

• Browse the API reference to discover every endpoint.
• Read the Guides for end-to-end walkthroughs (uploading a video, assembling a course).
• Subscribe to Webhooks so you don't have to poll.