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

Headers0

BodyJSON

Examples

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

Update User Invoicing

Update a customer's invoicing details for your Telegram or Discord subscription bot using an unrestricted project API key.

PATCH/v2/projects/{project_id}/users/{user_id}/invoicing

Authorization

Bearer API KeyRequired

API key access: Unrestricted project API key required. Restricted keys cannot call this endpoint.

Supply an explicit user_id; the me alias is not supported by project API keys.

Path Parameters

project_idstringrequired

The unique identifier of the project.

user_idstringrequired

The user ID to update invoicing settings for.

Request Body

namestring

Full name for invoicing.

emailstring

Email address for invoicing.

addressstring

Street address.

citystring

City name.

regionstring

State, province, or region.

postalstring

Postal or ZIP code.

countrystring

Country code (e.g., US, GB).

vat_numberstring

VAT registration number (for EU businesses).

curl -X PATCH "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/users/123456789012345678/invoicing" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "address": "123 Main St",
    "city": "New York",
    "region": "NY",
    "postal": "10001",
    "country": "US"
  }'

const project_id = 'YOUR_PROJECT_ID';
const user_id = '123456789012345678';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/users/${user_id}/invoicing`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'John Doe',
    email: 'john@example.com',
    address: '123 Main St',
    city: 'New York',
    region: 'NY',
    postal: '10001',
    country: 'US'
  })
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
user_id = '123456789012345678'
response = requests.patch(
    f'https://api.botsubscription.com/v2/projects/{project_id}/users/{user_id}/invoicing',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'John Doe',
        'email': 'john@example.com',
        'address': '123 Main St',
        'city': 'New York',
        'region': 'NY',
        'postal': '10001',
        'country': 'US'
    }
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$user_id = '123456789012345678';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/users/{$user_id}/invoicing");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'name' => 'John Doe',
    'email' => 'john@example.com',
    'address' => '123 Main St',
    'city' => 'New York',
    'region' => 'NY',
    'postal' => '10001',
    'country' => 'US'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Invoicing updatedapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/users/123456789012345678/invoicing",
  "code": 200,
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "address": "123 Main St",
    "city": "New York",
    "region": "NY",
    "postal": "10001",
    "country": "US",
    "vat_number": null,
    "state_code": "NY",
    "legal_consents": {
      "terms": {
        "version": "2026-01",
        "accepted_at": "2026-01-01T10:00:00.000Z"
      },
      "privacy": {
        "version": "2026-01",
        "accepted_at": "2026-01-01T10:00:00.000Z"
      }
    }
  }
}

User not foundapplication/json

{
  "ok": false,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/users/123456789012345678/invoicing",
  "code": 404,
  "error": {
    "error_code": "NOT_FOUND",
    "message": "User not found"
  }
}

Invalid or expired API keyapplication/json

{
  "ok": false,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/users/123456789012345678/invoicing",
  "code": 401,
  "error": {
    "message": "Invalid or expired authentication token.",
    "error_code": "UNAUTHORIZED"
  }
}

Last updated: November 4, 2026