---
title: "Create a curated news article"
method: POST
path: "/api/news/article"
tags: ["News"]
---

# Create a curated news article

`POST /api/news/article`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/news/article`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/news/article/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new curated news article with associated companies, agencies, teams, and tags. Requires news administration permission.

## Headers

- `X-Agent-Name` string

## Request body

- object
  - `url` string, url, required: Article URL. Must be unique among usable articles: a URL left behind by a failed article is accepted (that article is purged), while one belonging to a declined article is rejected until it is restored or deleted.
  - `title` string, required: Article title
  - `description` string, required: Article description
  - `image` string, nullable: Image URL for the article. Absent, null or empty: the article is created without a logo (logo_id stays null); no logo is resolved from the article URL.
  - `published_at` string, date-time: Publication date (defaults to now)
  - `is_sponsorship` boolean
  - `companies` object[]: Array of company objects to associate
    - `id` integer
  - `agencies` object[]: Array of agency objects to associate
    - `id` integer
  - `teams` object[]: Array of team/property objects to associate
    - `id` integer
  - `tags` integer[]: Array of news tag IDs

## Response `200`

Article created successfully

- CuratedNews
  - `id` integer
  - `url` string
  - `is_active` integer
  - `reporter_id` integer
  - `title` string
  - `description` string
  - `image` string
  - `created_at` string, date-time
  - `content_markdown` string
  - `ingestion_request_id` string
  - `updated_at` string, date-time
  - `published_at` string, date-time

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden — missing news administration permission
- `422`: Validation error

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)