API: Send Episode Clips to Notion

Send all ready Clips created by the authenticated user for an Episode to the configured Notion Clip database. Clips that are not ready are skipped and counted separately.

Endpoint

POSThttps://app.podwise.ai/api/open/v1/episodes/[seq]/clips/send/notion

Path Parameters

seq: Episode sequence number.

Response


type Response = {
  success: true,
  result: {
    successCount: number,
    unexportableClipCount: number,
    url: string | null,
  },
  episode: {
    episodeId: string,
    seq: number,
    title: string | null,
    podcastName: string,
  },
}

Error Responses

Status	Error	Description
400	—	Invalid Episode sequence number.
400	`not_connected`	Notion is not connected.
400	`not_configured`	The Notion Clip database is not configured.
400	`property_not_exists`	A configured Notion property does not exist.
401	`unauthorized`	The Notion API token is invalid or expired.
402	—	Open API or export features are not available for the current plan.
404	`not_found`	Episode does not exist.
404	`no_ready_clips`	Episode has no ready Clips to export.
404	`database_not_found`	The configured Notion database was not found.
429	`rate_limited`	Notion rate limited the request.
502	`notion_error`	Unexpected Notion API error.
504	`timeout`	Notion API request timed out.

Authorization Error Codes