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.

Request

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: January 25, 2026

API Endpoint

Create API Key - Generate Access Token for Your Bot

Authorization

Path Parameters

Request Body