api.botsubscription.com

GET/v1/endpoint

AuthenticationBearer

Token

Stays in this tab. Required for this endpoint — the value below is what gets sent.

Path parameters0

Query parameters0

BodyJSON

Mock

curl --request GET \
  --url https://api.botsubscription.com/v1/endpoint \
  --header 'Authorization: Bearer sk_live_•••'

Create API Key - Generate Access Token for Your Bot

Generate a new API key for programmatic access to your BotSubscription project. The secret key is displayed only once in the response—store it securely because you cannot retrieve it again. Use labels to identify what each key is used for.

POST/v2/projects/{project_id}/integrations/api-keys

Authorization

Bearer TokenRequired

Path Parameters

project_idstringrequired

The unique identifier of the project.

Request Body

labelstringrequired

A human-readable label for the API key.

curl -X POST "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/integrations/api-keys" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "staging bot"
  }'

const project_id = 'YOUR_PROJECT_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/integrations/api-keys`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    label: 'staging bot'
  })
});
const data = await response.json();
// Store data.key securely - it won't be shown again!

import requests
 
project_id = 'YOUR_PROJECT_ID'
response = requests.post(
    f'https://api.botsubscription.com/v2/projects/{project_id}/integrations/api-keys',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    json={'label': 'staging bot'}
)
data = response.json()
# Store data['key'] securely - it won't be shown again!

$project_id = 'YOUR_PROJECT_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/integrations/api-keys");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'label' => 'staging bot'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
// Store the key securely - it won't be shown again!

API key createdapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "POST",
  "path": "/v2/projects/YOUR_PROJECT_ID/integrations/api-keys",
  "code": 200,
  "message": "API key created successfully",
  "data": {
    "key": "your_api_key_secret_here",
    "metadata": {
      "id": "22222222-2222-2222-2222-222222222222",
      "label": "staging bot",
      "last_four": "here",
      "created_at": "2025-02-10T09:30:12.000Z",
      "created_by": null,
      "updated_at": "2025-02-10T09:30:12.000Z",
      "updated_by": null,
      "revoked_at": null,
      "revoked_by": null
    }
  }
}

Last updated: May 28, 2026