Workspace

1 endpoint

The workspace, environment and abilities of the token you're using.

Get the current token#

GET/me

Use this to check a token works and see what it can do — it's what Zapier's "Test connection" step should call. It needs no ability of its own, so it always answers once the token is valid, whatever platform_api_enabled says.

Responses

200

200 response

{
  "data": {
    "workspace": {
      "id": "0192f0a4-6b1e-7c3a-9d2f-5e8b1a4d1001",
      "name": "Acme Coffee"
    },
    "environment": "production",
    "abilities": [
      "reports:read",
      "campaigns:read",
      "campaigns:write"
    ],
    "platform_api_enabled": true
  }
}

Response fields

data

object

required

data.workspace

object

required

data.workspace.id

string

required

data.workspace.name

string

required

data.environment

string

required

data.abilities

string | string[]

required

data.platform_api_enabled

string

required

Whether abilities beyond reports:read currently work — the gate can close on an existing token, so this is worth surfacing alongside the abilities it was issued with.

401

The token is missing, unknown, revoked or expired.

missing_tokeninvalid_tokentoken_revokedtoken_expired

missing_token
Missing bearer token.
invalid_token
Unknown API token. Check it was copied in full, and that it is for this environment.
token_revoked
The token "Zapier" was revoked on 2026-10-06 at 18:27 UTC. Issue a new one from Configuration › Platform API.
token_expired
This token has expired. Issue a new one from Configuration › Platform API.

401 response

{
  "error": {
    "code": "missing_token",
    "message": "Missing bearer token."
  }
}

403

The token or workspace can't do this.

wrong_environmentworkspace_paused

wrong_environment
This is a Sandbox token: use the Sandbox API address. https://api.sandbox.bubbl.tech/platform/v1
workspace_paused
This workspace is scheduled for deletion; its API access is paused.

403 response

{
  "error": {
    "code": "wrong_environment",
    "message": "This is a Sandbox token: use the Sandbox API address. https://api.sandbox.bubbl.tech/platform/v1"
  }
}

429

Too many requests. Wait for the number of seconds in Retry-After.

rate_limitedtoo_many_failed_attempts

rate_limited
Too many requests. Slow down and try again shortly.
too_many_failed_attempts
Too many failed attempts. Try again shortly.

429 response

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Slow down and try again shortly."
  }
}

Request

curl 'https://api.bubbl.tech/platform/v1/me' \
  -H 'Authorization: Bearer bubbl_YOUR_TOKEN' \
  -H 'Accept: application/json'

Request

const response = await fetch('https://api.bubbl.tech/platform/v1/me', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer bubbl_YOUR_TOKEN',
    Accept: 'application/json',
  },
});

const data = await response.json();

Request

import requests

response = requests.request(
    'GET',
    'https://api.bubbl.tech/platform/v1/me',
    headers={
        'Authorization': 'Bearer bubbl_YOUR_TOKEN',
        'Accept': 'application/json',
    },
)
response.raise_for_status()
data = response.json()

Request

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.bubbl.tech/platform/v1/me', [
    'headers' => [
        'Authorization' => 'Bearer bubbl_YOUR_TOKEN',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode((string) $response->getBody(), true);