Other Endpoints

Time slots, subscription, settings, and teams.

Postman CollectionDownload the ready-made collection with all endpoints pre-configured.

Use with Claude, ChatGPT & moreConnect any AI assistant to BlackTwist via our MCP server. No code required.

Time Slots

`GET /api/v1/time-slots`

Returns configured posting time slots for a provider. Time slots define the recurring times at which posts can be automatically scheduled.Query Parameters:

providerId (required) — Provider ID from the /providers endpoint
teamId (optional) — Team ID

Request

curl "https://blacktwist.app/api/v1/time-slots?providerId=clx...." \
  -H "Authorization: Bearer bt_api_..."

Response

{
  "timeSlots": [
    {
      "timeSlotHour": 9,
      "timeSlotMinute": 0,
      "weekDays": [1, 2, 3, 4, 5]
    },
    {
      "timeSlotHour": 17,
      "timeSlotMinute": 30,
      "weekDays": [1, 3, 5]
    }
  ]
}

Response Fields:

timeSlotHour — Hour in your configured timezone (0–23)
timeSlotMinute — Minute (0–59)
weekDays — Array of day numbers (0 = Sunday, 1 = Monday, ... 6 = Saturday)

Subscription

`GET /api/v1/subscription`

Returns your current subscription plan details, limits, and remaining post quota.Query Parameters:

teamId (optional) — Team ID

Request

curl https://blacktwist.app/api/v1/subscription \
  -H "Authorization: Bearer bt_api_..."

Response

{
  "planType": "paid",
  "planName": "Pro Monthly",
  "isFreePlan": false,
  "remainingPosts": "unlimited",
  "limits": {
    "maxTeams": 3,
    "maxMembers": 5,
    "maxAccounts": 10
  },
  "teamPlan": null,
  "currentTeam": null
}

Plan Types:

free — Free plan with limited scheduling
paid — Active paid subscription
ltd — Lifetime deal
agency_ltd — Agency lifetime deal
team — Access through a team team plan

Settings

`GET /api/v1/settings`

Returns your account settings.

Request

curl https://blacktwist.app/api/v1/settings \
  -H "Authorization: Bearer bt_api_..."

Response

{
  "notificationsTimezone": "America/New_York",
  "dateFormat": "12-hours",
  "calendarDateFormat": "MM/DD",
  "autoRepostEnabled": true,
  "autoRepostDelays": ["168", "336"],
  "dailyEmailEnabled": true,
  "reminderType": "smart",
  "reminderTime": "09:00"
}

Key Fields:

notificationsTimezone — IANA timezone used for scheduling and date interpretation
dateFormat — "24-hours" or "12-hours"
autoRepostDelays — Default auto-repost delays in hours
reminderType — "daily", "smart", or "off"
reminderTime — HH:mm format, stored in UTC

Teams

`GET /api/v1/teams`

Returns all teams the authenticated user belongs to, including the personal team. The isActive field indicates which team is currently selected.

Request

curl https://blacktwist.app/api/v1/teams \
  -H "Authorization: Bearer bt_api_..."

Response

{
  "teams": [
    {
      "id": "personal",
      "name": "Personal",
      "role": "OWNER",
      "isActive": true
    },
    {
      "id": "ws_abc123",
      "name": "Marketing Team",
      "role": "ADMIN",
      "isActive": false,
      "createdAt": "2025-01-10T12:00:00.000Z"
    }
  ]
}

Roles:

OWNER — Team owner (full permissions)
ADMIN — Admin with management permissions
MEMBER — Regular member

Follow-ups