Publishing

ShortGenius lets you publish your videos automatically to various platforms (TikTok, YouTube, X, etc.). This section covers how to manage these connections and how to utilize them in your video creation workflow.

---

Listing Publishing Destinations

Endpoint: GET /connections

This endpoint returns all the publishing destinations (a.k.a. “connections”) you’ve set up in your ShortGenius account. Examples include TikTok, YouTube, X, and Email.

curl --request GET \
  --url "https://shortgenius.com/api/v1/connections" \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Sample Response:

[
  {
    "id": "95c87129-3e78-49ee-8305-d7bd5201263a",
    "type": "TikTok",
    "name": "My TikTok Account"
  },
  {
    "id": "00d10d95-b58c-4a60-9cae-578490ab5201",
    "type": "YouTube",
    "name": "My YouTube Channel"
  },
  {
    "id": "9830b2d9-76f7-4471-b5f6-a33041555c75",
    "type": "X",
    "name": "My Twitter/X Profile"
  }
]

Response Fields

Field	Description
id	Unique ID for this connection. You’ll pass this to /videos or /series when publishing.
type	The platform type (e.g., "TikTok", "YouTube", "X", "Email").
name	A user-friendly name for your reference.

---

Using Connections in Video Creation

When creating or scheduling videos and series, you can specify which connection(s) to publish to.

For example, in POST /videos:

{
  "connection_ids": [
    "95c87129-3e78-49ee-8305-d7bd5201263a"
  ],
  "title": "Fun AI Video",
  "caption": "Check out this AI-created content!",
  ...
}

ShortGenius will automatically publish the generated video to the specified platform once it finishes rendering (and according to any publish_at scheduling you set).

Scheduling Videos

If you use the publish_at field in your POST /videos body, ShortGenius will delay the publish time until your desired date/time (in ISO 8601 format). For example:

"publish_at": "2025-06-01T10:00:00Z"

When that time arrives, ShortGenius begins publishing to your designated connections (e.g., TikTok, YouTube, etc.).

---

Using Connections in Series

Similarly, for POST /series, include an array of connection_ids to apply an automated schedule across multiple episodes:

{
  "connection_ids": [
    "00d10d95-b58c-4a60-9cae-578490ab5201",
    "9830b2d9-76f7-4471-b5f6-a33041555c75"
  ],
  "aspect_ratio": "556",
  "locale": "en-US",
  "schedule": {
    "timeZone": "America/Denver",
    "times": [
      { "dayOfWeek": 2, "timeOfDay": 900 }
    ]
  },
  ...
}

Each video in that series will automatically publish to the selected platforms at the scheduled times.

---

Publishing State

ShortGenius tracks the publishing_state of each video:

• pending – Video is waiting to be processed or published.

• processing – Video is being rendered or is about to be uploaded.

• completed – Successfully published.

• skipped – Publishing skipped for some reason (e.g., missing credentials).

• error – An error occurred during publishing.

You can view this state in the response from:

• GET /videos

• GET /videos/{id}

• GET /series/{id} (for each episode)

---

Troubleshooting Publishing

If publishing fails:

1. Check your connection credentials on the ShortGenius dashboard.

2. Ensure your publishing time (publish_at) is not in the past.

3. Review the error in the video’s publishing_state. If you see "error", there may be a message in the response body (such as missing permissions).

---

Next Steps

Now that you can publish and schedule your AI-generated videos, you might want to keep an eye on your usage and credits. Head over to the Usage & Credits section to learn how to manage resources effectively.