curl -X POST "https://api.hooked.so/v1/schedule/create" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "videoId": "cm5e6f7g8h9i0j1k2l3m4n5o6",
    "integrationId": "cm3c4d5e6f7g8h9i0j1k2l3m4",
    "scheduledDateTime": "2026-10-05T15:00:00Z",
    "platformData": {
      "title": "5 tips for better sleep",
      "description": "Simple habits that help.",
      "privacyStatus": "public"
    }
  }'

const response = await fetch('https://api.hooked.so/v1/schedule/create', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.HOOKED_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    videoId: 'cm5e6f7g8h9i0j1k2l3m4n5o6',
    integrationId: 'cm3c4d5e6f7g8h9i0j1k2l3m4',
    scheduledDateTime: new Date(Date.now() + 2 * 60 * 60 * 1000).toISOString(),
    platformData: { title: '5 tips for better sleep' }
  })
});

const { data } = await response.json();
console.log(data.scheduleId);

import requests
from datetime import datetime, timedelta, timezone

when = (datetime.now(timezone.utc) + timedelta(hours=2)).strftime('%Y-%m-%dT%H:%M:%SZ')

response = requests.post(
    'https://api.hooked.so/v1/schedule/create',
    headers={'x-api-key': 'your_api_key_here'},
    json={
        'videoId': 'cm5e6f7g8h9i0j1k2l3m4n5o6',
        'integrationId': 'cm3c4d5e6f7g8h9i0j1k2l3m4',
        'scheduledDateTime': when,
    }
)

print(response.json()['data']['scheduleId'])

{
  "success": true,
  "message": "Video scheduled successfully",
  "data": {
    "scheduleId": "cm6f7g8h9i0j1k2l3m4n5o6p7",
    "status": "pending",
    "scheduledDateTime": "2026-10-05T15:00:00.000Z",
    "platform": "youtube",
    "videoId": "cm5e6f7g8h9i0j1k2l3m4n5o6"
  }
}

{
  "code": "bad_request",
  "message": "Invalid input",
  "errorCode": "INVALID_INPUT",
  "details": {
    "scheduledDateTime": ["scheduledDateTime must be a valid ISO 8601 date"]
  }
}

{
  "code": "bad_request",
  "message": "Video must be completed before scheduling",
  "errorCode": "INVALID_INPUT",
  "details": { "videoStatus": "processing" }
}

{
  "code": "bad_request",
  "message": "Scheduled time must be in the future",
  "errorCode": "INVALID_INPUT",
  "details": {
    "scheduledDateTime": "2026-09-01T10:00:00Z",
    "currentTime": "2026-10-01T10:30:00.000Z"
  }
}

{
  "code": "not_found",
  "message": "Video not found",
  "errorCode": "RESOURCE_NOT_FOUND",
  "details": { "resource_id": "cm5e6f7g8h9i0j1k2l3m4n5o6", "resource_type": "Video" }
}