Account

List accounts

GET

https://0bull.net/api

/v1/accounts

Returns the authenticated user's own posting accounts, newest first, 50 per page. Every platform is included unless platform narrows it to one.

List accounts › query Parameters

page

integer

Page number of the paginated result set.

Default: 1

platform

string · enum

Only accounts on this platform. Omit for every platform, merged.

Enum values:

tiktok

instagram

youtube

List accounts › Responses

Paginated set of AccountResource

AccountResource[] · required

object · required

GET/v1/accounts

curl https://0bull.net/api/v1/accounts \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "id",
      "platform": "platform",
      "handle": "handle",
      "slot": "slot",
      "notes": "notes",
      "google_email": "google_email",
      "created_at": "created_at",
      "updated_at": "updated_at"
    }
  ],
  "links": {
    "first": "first",
    "last": "last",
    "prev": "prev",
    "next": "next"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "url",
        "label": "label",
        "active": true
      }
    ],
    "path": "path",
    "per_page": 0,
    "to": 1,
    "total": 0
  }
}

json

application/json

Create an account

POST

https://0bull.net/api

/v1/accounts

platform chooses where the account posts and defaults to tiktok. The account must already be signed in on the phone at slot, or have no slot yet for a record-only entry: this endpoint links an account, it does not sign one in.

handle is required on every platform. YouTube also requires google_email, the Google account address of the channel; every other platform rejects it.

Create an account › Request Body

StoreAccountRequest

handle

string · maxLength: 255 · required

platform

Platform · enum

Which platform to create the account on. Defaults to tiktok.

Enum values:

tiktok

instagram

youtube

Required for TikTok, capped at 4 accounts per phone. Optional for Instagram and YouTube.

notes

string | null · maxLength: 2000

The Google account address. Required for YouTube, rejected on every other platform.

Create an account › Responses

AccountResource

AccountResource · required

Get an account

GET

https://0bull.net/api

/v1/accounts/{account}

Works for an account on any platform: the id alone identifies it.

Get an account › path Parameters

account

integer · required

The account ID

Get an account › Responses

AccountResource

AccountResource · required

Update an account

PUT

https://0bull.net/api

/v1/accounts/{account}

Only the supplied fields are changed. The platform cannot be changed here.

handle, slot and notes can be updated on any platform. google_email can only be set on a YouTube account; every other platform rejects it.

Update an account › path Parameters

account

integer · required

The account ID

Update an account › Request Body

UpdateAccountRequest

handle

string · maxLength: 255

notes

string | null · maxLength: 2000

The Google account address. Only editable on YouTube.

Update an account › Responses

AccountResource

AccountResource · required

Delete an account

DELETE

https://0bull.net/api

/v1/accounts/{account}

Removes the account from 0bull. This does not delete the account on the platform itself.

Delete an account › path Parameters

account

integer · required

The account ID

Delete an account › Responses

No content

No data returned

Billing

List accounts

GET

https://0bull.net/api

/v1/accounts

Returns the authenticated user's own posting accounts, newest first, 50 per page. Every platform is included unless platform narrows it to one.

List accounts › query Parameters

page

integer

Page number of the paginated result set.

Default: 1

platform

string · enum

Only accounts on this platform. Omit for every platform, merged.

Enum values:

tiktok

instagram

youtube

List accounts › Responses

Paginated set of AccountResource

AccountResource[] · required

object · required

Create an account

POST

https://0bull.net/api

/v1/accounts

handle is required on every platform. YouTube also requires google_email, the Google account address of the channel; every other platform rejects it.

Create an account › Request Body

StoreAccountRequest

handle

string · maxLength: 255 · required

platform

Platform · enum

Which platform to create the account on. Defaults to tiktok.

Enum values:

tiktok

instagram

youtube

Required for TikTok, capped at 4 accounts per phone. Optional for Instagram and YouTube.

notes

string | null · maxLength: 2000

The Google account address. Required for YouTube, rejected on every other platform.

Create an account › Responses

AccountResource

AccountResource · required

Update an account

PUT

https://0bull.net/api

/v1/accounts/{account}

Only the supplied fields are changed. The platform cannot be changed here.

handle, slot and notes can be updated on any platform. google_email can only be set on a YouTube account; every other platform rejects it.

Update an account › path Parameters

account

integer · required

The account ID

Update an account › Request Body

UpdateAccountRequest

handle

string · maxLength: 255

notes

string | null · maxLength: 2000

The Google account address. Only editable on YouTube.

Update an account › Responses

AccountResource

AccountResource · required