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_•••'

Activate Subscription Bot Access Tokens

Activate a saved batch for your Telegram subscription bot or Discord subscription bot. Codes become usable only after this step succeeds.

POST/v2/projects/{project_id}/access-tokens/activate

Authorization

Bearer TokenRequired

Requires memberships:add for a human admin. Restricted project API keys need access-tokens:create. Use the same user or API key that prepared the batch.

Path Parameters

project_idstringrequired

The UUID of the project.

Request Body

activation_tokenstringrequired

The complete, unexpired activation ticket returned when preparing this batch.

Behavior and recovery

Use the same authenticated user or API key that prepared the batch:

Activation rechecks permissions, plan availability, and generation quota, then activates the entire batch. The response contains token-free metadata; it does not return the plaintext codes again.

Retry a lost activation response with the same ticket before it expires. This does not create another batch or reactivate revoked or redeemed codes. After expiry, list tokens and match the saved IDs to determine whether activation committed. Discard an unactivated draft to cancel it; its IDs cannot be revoked before activation.

The data array contains one metadata object per token. An initial activation returns 201; a completed activation retry returns 200.

Start with Prepare Tokens and use List Tokens to inspect activated IDs after an uncertain result.

curl -X POST "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/activate" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "activation_token": "YOUR_SAVED_ACTIVATION_TICKET"
}'

const response = await fetch("https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/activate", {
  method: 'POST',
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "activation_token": "YOUR_SAVED_ACTIVATION_TICKET"
  })
});
const result = await response.json();

import requests
 
response = requests.post(
    "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/activate",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
        "activation_token": "YOUR_SAVED_ACTIVATION_TICKET"
    }
)
result = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/activate');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'activation_token' => 'YOUR_SAVED_ACTIVATION_TICKET'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Batch activatedapplication/json

{
  "ok": true,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "POST",
  "path": "/v2/projects/YOUR_PROJECT_ID/access-tokens/activate",
  "code": 201,
  "message": "Success",
  "data": [
    {
      "access_token_id": "11111111-1111-4111-8111-111111111111",
      "plan_id": "22222222-2222-4222-8222-222222222222",
      "duration_seconds": null,
      "duration_months": 1,
      "created_at": 1792430400000,
      "revoked_at": null,
      "claimed_at": null,
      "claimed_by": null,
      "claimed_membership_id": null,
      "grant_end_date": null
    }
  ]
}

Batch already activatedapplication/json

{
  "ok": true,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "POST",
  "path": "/v2/projects/YOUR_PROJECT_ID/access-tokens/activate",
  "code": 200,
  "message": "Success",
  "data": [
    {
      "access_token_id": "11111111-1111-4111-8111-111111111111",
      "plan_id": "22222222-2222-4222-8222-222222222222",
      "duration_seconds": null,
      "duration_months": 1,
      "created_at": 1792430400000,
      "revoked_at": null,
      "claimed_at": null,
      "claimed_by": null,
      "claimed_membership_id": null,
      "grant_end_date": null
    }
  ]
}

Last updated: October 19, 2026