SubmissionBatch

Submit a video to several accounts

POST

https://0bull.net/api

/v1/submissions/batches

Uploads one video and queues a submission for every destination, across TikTok, Instagram and YouTube in one call. Provide the video exactly one way: a multipart video, a public video_url, or an upload_id from POST /v1/uploads.

Returns 201 with the batch and its submissions. Poll GET /v1/submissions/batches/{batch} for the whole drop, poll each submission on its own, or pass webhook_url to be called as each one finishes. If any destination is invalid, nothing is created.

Submit a video to several accounts › Request Body

StoreSubmissionBatchRequest

object[] · minItems: 1 · maxItems: 50 · required

Where to post. One entry per account; the same account may not be listed twice. Accounts must belong to you and be assigned to a phone.

video

string | null · binary

Video file, up to 200 MB. Accepted types: MP4, MOV.

video_url

string | null · uri

upload_id

string | null

caption

string | null · maxLength: 2200

The caption posted on TikTok and Instagram destinations, up to 2200 characters. Ignored on YouTube, which takes youtube_title instead.

youtube_title

string | null · maxLength: 100

The Short's title on YouTube destinations, up to 100 characters. Required when any destination is on YouTube.

draft

boolean | null

Save as a draft on the phone instead of publishing. Defaults to false.

scheduled_at

string | null · date-time

When to publish every post in the drop, as an ISO 8601 timestamp in the future. Omit to publish now.

webhook_url

string | null · uri · maxLength: 2048

An https URL to POST to as each submission in the drop reaches a terminal status. One delivery per submission, not per drop.

Submit a video to several accounts › Responses

SubmissionBatchResource

SubmissionBatchResource · required

POST/v1/submissions/batches

curl https://0bull.net/api/v1/submissions/batches \
  --request POST \
  --header 'Content-Type: multipart/form-data' \
  --header 'Authorization: Bearer <token>' \
  --form 'video=<binary>' \
  --form 'video_url=https://www.example.com/path/to/resource' \
  --form 'upload_id=upload_id' \
  --form 'caption=caption' \
  --form 'youtube_title=youtube_title' \
  --form 'draft=true' \
  --form 'scheduled_at=2024-08-25T15:00:00Z' \
  --form 'webhook_url=https://www.example.com/path/to/resource' \
  --form 'destinations={"platform":"tiktok","account_id":"account_id"}'

Example Request Body

{
  "video": "<binary>",
  "video_url": "https://www.example.com/path/to/resource",
  "upload_id": "upload_id",
  "caption": "caption",
  "youtube_title": "youtube_title",
  "draft": true,
  "scheduled_at": "2024-08-25T15:00:00Z",
  "webhook_url": "https://www.example.com/path/to/resource",
  "destinations": [
    {
      "platform": "tiktok",
      "account_id": "account_id"
    }
  ]
}

text

Example Responses

{
  "data": {
    "id": 0,
    "caption": "caption",
    "youtube_title": "youtube_title",
    "draft": true,
    "scheduled_at": "scheduled_at",
    "webhook_url": "webhook_url",
    "running": true,
    "submissions": [
      {
        "id": 0,
        "platform": "platform",
        "account_id": "account_id",
        "batch_id": 0,
        "caption": "caption",
        "draft": true,
        "status": "scheduled",
        "attempts": 0,
        "failure": {
          "step": "step",
          "message": "Publishing failed on the phone. Retry, or contact support with this submission id."
        },
        "scheduled_at": "scheduled_at",
        "webhook_url": "webhook_url",
        "started_at": "started_at",
        "finished_at": "finished_at",
        "created_at": "created_at",
        "updated_at": "updated_at"
      }
    ],
    "created_at": "created_at",
    "updated_at": "updated_at"
  }
}

json

application/json

Get a batch

GET

https://0bull.net/api

/v1/submissions/batches/{batch}

Returns the drop with every submission in it. running is true while any of them is still scheduled, queued or on a phone.

Get a batch › path Parameters

batch

integer · required

The batch ID

Get a batch › Responses

SubmissionBatchResource

SubmissionBatchResource · required

GET/v1/submissions/batches/{batch}

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

Example Responses

{
  "data": {
    "id": 0,
    "caption": "caption",
    "youtube_title": "youtube_title",
    "draft": true,
    "scheduled_at": "scheduled_at",
    "webhook_url": "webhook_url",
    "running": true,
    "submissions": [
      {
        "id": 0,
        "platform": "platform",
        "account_id": "account_id",
        "batch_id": 0,
        "caption": "caption",
        "draft": true,
        "status": "scheduled",
        "attempts": 0,
        "failure": {
          "step": "step",
          "message": "Publishing failed on the phone. Retry, or contact support with this submission id."
        },
        "scheduled_at": "scheduled_at",
        "webhook_url": "webhook_url",
        "started_at": "started_at",
        "finished_at": "finished_at",
        "created_at": "created_at",
        "updated_at": "updated_at"
      }
    ],
    "created_at": "created_at",
    "updated_at": "updated_at"
  }
}

json

application/json

Cancel a batch

POST

https://0bull.net/api

/v1/submissions/batches/{batch}/cancel

Stops every submission in the drop that has not finished. Submissions that already reached a terminal status are left as they are, so this never fails on a partly finished drop.

Cancel a batch › path Parameters

batch

integer · required

The batch ID

Cancel a batch › Responses

SubmissionBatchResource

SubmissionBatchResource · required

POST/v1/submissions/batches/{batch}/cancel

curl https://0bull.net/api/v1/submissions/batches/:batch/cancel \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": 0,
    "caption": "caption",
    "youtube_title": "youtube_title",
    "draft": true,
    "scheduled_at": "scheduled_at",
    "webhook_url": "webhook_url",
    "running": true,
    "submissions": [
      {
        "id": 0,
        "platform": "platform",
        "account_id": "account_id",
        "batch_id": 0,
        "caption": "caption",
        "draft": true,
        "status": "scheduled",
        "attempts": 0,
        "failure": {
          "step": "step",
          "message": "Publishing failed on the phone. Retry, or contact support with this submission id."
        },
        "scheduled_at": "scheduled_at",
        "webhook_url": "webhook_url",
        "started_at": "started_at",
        "finished_at": "finished_at",
        "created_at": "created_at",
        "updated_at": "updated_at"
      }
    ],
    "created_at": "created_at",
    "updated_at": "updated_at"
  }
}

json

application/json

Submission Upload

Submit a video to several accounts

POST

https://0bull.net/api

/v1/submissions/batches

Submit a video to several accounts › Request Body

StoreSubmissionBatchRequest

object[] · minItems: 1 · maxItems: 50 · required

Where to post. One entry per account; the same account may not be listed twice. Accounts must belong to you and be assigned to a phone.

video

string | null · binary

Video file, up to 200 MB. Accepted types: MP4, MOV.

video_url

string | null · uri

upload_id

string | null

caption

string | null · maxLength: 2200

The caption posted on TikTok and Instagram destinations, up to 2200 characters. Ignored on YouTube, which takes youtube_title instead.

youtube_title

string | null · maxLength: 100

The Short's title on YouTube destinations, up to 100 characters. Required when any destination is on YouTube.

draft

boolean | null

Save as a draft on the phone instead of publishing. Defaults to false.

scheduled_at

string | null · date-time

When to publish every post in the drop, as an ISO 8601 timestamp in the future. Omit to publish now.

webhook_url

string | null · uri · maxLength: 2048

An https URL to POST to as each submission in the drop reaches a terminal status. One delivery per submission, not per drop.

Submit a video to several accounts › Responses

SubmissionBatchResource

SubmissionBatchResource · required

Get a batch

GET

https://0bull.net/api

/v1/submissions/batches/{batch}

Returns the drop with every submission in it. running is true while any of them is still scheduled, queued or on a phone.

Get a batch › path Parameters

batch

integer · required

The batch ID

Get a batch › Responses

SubmissionBatchResource

SubmissionBatchResource · required

Cancel a batch

POST

https://0bull.net/api

/v1/submissions/batches/{batch}/cancel

Stops every submission in the drop that has not finished. Submissions that already reached a terminal status are left as they are, so this never fails on a partly finished drop.

Cancel a batch › path Parameters

batch

integer · required

The batch ID

Cancel a batch › Responses

SubmissionBatchResource

SubmissionBatchResource · required