> ## Documentation Index > Fetch the complete documentation index at: https://docs.linqalpha.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Briefing Schedule > Create a new briefing with topic, tickers, and schedule in a single call. Create a new briefing schedule with topic, tickers, and delivery timing in a single API call. The briefing will be automatically generated and delivered via email at the scheduled time. ## Stock Selection You can specify stocks in two ways: * **`stock_ids`** (recommended) — Internal stock UUIDs. Use the [Map Tickers](/api-reference/basic/map_tickers) endpoint to convert ticker symbols to stock IDs first. * **`tickers`** — Ticker symbols (e.g. `["AAPL", "MSFT"]`). Automatically resolved to stock IDs via the ticker mapping service. If resolution fails, the request will return an error. If both `stock_ids` and `tickers` are provided, `stock_ids` takes priority. ## Scheduled Time Format The `scheduled_time` field must be in 12-hour AM/PM format: * `"9:00 AM"`, `"3:30 PM"`, `"12:00 PM"` ## Timezone Must be a valid IANA timezone identifier. Common examples: | Region | Timezone | | ---------- | --------------------- | | Korea | `Asia/Seoul` | | Hong Kong | `Asia/Hong_Kong` | | China | `Asia/Shanghai` | | Singapore | `Asia/Singapore` | | Taiwan | `Asia/Taipei` | | Japan | `Asia/Tokyo` | | India | `Asia/Calcutta` | | Indonesia | `Asia/Jakarta` | | Malaysia | `Asia/Kuala_Lumpur` | | Australia | `Australia/Sydney` | | UK | `Europe/London` | | US East | `America/New_York` | | US West | `America/Los_Angeles` | | US Central | `America/Chicago` | | UTC | `UTC` | ## Language Supported values: `English`, `Spanish`, `French`, `German`, `Italian`, `Portuguese`, `Dutch`, `Hindi`, `Japanese`, `Chinese`, `Finnish`, `Korean`, `Polish`, `Russian`, `Turkish`, `Ukrainian`, `Vietnamese`. Pass `null` for auto-detection. ## Authentication For platform API keys, you can optionally pass `organization_id`, `user_id`, `user_email`, and `user_name` in the request body to specify which user the briefing is created for. ## OpenAPI ````yaml POST /v1/briefings openapi: 3.0.1 info: title: LinqAlpha API description: >- Linq helps finance professionals make informed decisions using Retrieval-Augmented Generation (RAG)-enhanced answers. By leveraging cutting-edge Large Language Models (LLM) and supplementary technology, Linq provides the most optimized responses based on your queries. version: 1.0.0 license: name: MIT servers: - url: https://api.linqalpha.com security: - ApiKeyAuth: [] tags: - name: Search description: Search and generate responses - name: Data description: Data retrieval and mapping - name: Feedback description: Conversation feedback - name: RMS description: Research Management System - name: Source Management description: Source batch and file management - name: MCP description: >- LinqAlpha MCP — Financial data tools for AI assistants via Model Context Protocol - name: Connectors description: Customer Connectors — customer-owned MCP connector management - name: Briefing description: Briefing Agent — automated market briefings with scheduling and delivery - name: Status description: Sync status — check organization, document, and container sync progress paths: /v1/briefings: post: tags: - Briefing summary: Create Briefing description: >- Create a new briefing with topic, tickers, and schedule in a single call. operationId: createBriefing requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BriefingCreateRequest' responses: '201': description: Briefing created content: application/json: schema: type: object properties: error: type: object nullable: true payload: $ref: '#/components/schemas/Briefing' components: schemas: BriefingCreateRequest: type: object required: - topic - scheduled_time - timezone properties: topic: type: string description: Briefing instructions/topic stock_ids: type: array items: type: string description: >- Internal stock UUIDs (preferred). Use /v1/map_tickers to convert ticker symbols. tickers: type: array items: type: string description: Ticker symbols (e.g. AAPL, 9988.HK). Auto-resolved to stock_ids. language: type: string nullable: true enum: - English - Spanish - French - German - Italian - Portuguese - Dutch - Hindi - Japanese - Chinese - Finnish - Korean - Polish - Russian - Turkish - Ukrainian - Vietnamese description: Output language (null = auto-detect) scheduled_time: type: string description: 'Time in h:mm AM/PM format. Examples: ''9:00 AM'', ''3:30 PM''' timezone: type: string description: >- IANA timezone identifier (e.g. America/New_York, Asia/Seoul, Europe/London) frequency: type: string enum: - daily - weekly - monthly default: daily scheduled_day_of_week: type: integer minimum: 0 maximum: 6 description: Day of week for weekly frequency (0=Sun, 1=Mon, ..., 6=Sat) scheduled_day_of_month: type: integer minimum: 1 maximum: 31 description: Day of month for monthly frequency title: type: string description: Custom briefing title (auto-generated if omitted) source_type: type: string enum: - tfs_only - rms_only - both default: tfs_only description: >- Data source: tfs_only (news+filings), rms_only (uploaded documents), both attach_pdf: type: boolean default: false description: Attach briefing as PDF to delivery email is_active: type: boolean default: true description: Enable/disable the schedule rms_sources: type: array items: type: object properties: source: type: string workspace: type: string description: RMS source configurations for storage-based briefing watchlist_group_id: type: string description: Link to watchlist group for dynamic ticker sync use_custom_email_title: type: boolean default: false description: Use briefing title as fixed email subject organization_id: type: string description: >- Platform (EDS) keys only: org UUID under the key's platform. Ignored by org-bound keys. user_id: type: string description: >- Platform (EDS) keys only: the target user's customer_id (your external user id, not a UUID). Ignored by org-bound keys. user_email: type: string description: >- Platform (EDS) keys only: the target user's email (used to find or create the user). Ignored by org-bound keys. user_name: type: string description: >- Platform (EDS) keys only: optional display name (used only when creating the user). Briefing: type: object properties: id: type: string title: type: string nullable: true topic: type: string tickers: type: array items: type: string language: type: string nullable: true scheduled_time: type: string description: >- Time in h:mm AM/PM format, echoing the value provided on create/update (e.g. '9:00 AM') timezone: type: string description: IANA timezone frequency: type: string enum: - daily - weekly - monthly scheduled_day_of_week: type: integer nullable: true scheduled_day_of_month: type: integer nullable: true next_delivery_at: type: string nullable: true is_active: type: boolean source_type: type: string attach_pdf: type: boolean created_at: type: string updated_at: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ````