> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Curated

> Curated is a platform that enables users to collect, curate, and publish newsletters, integrating with various services through its API.

![Curated logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/curated.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=8fd44c4cfeba1f718f6fec10145d9ac1)

* **Category:** email newsletters
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `CURATED`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Draft Issue
>
> **Slug:** `CURATED_CREATE_DRAFT_ISSUE`
>
> Tool to create a draft issue for a publication. Use after confirming the publication ID. Applies default settings if optional fields are omitted.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Title of the new draft issue
>
> **editor\_note** `string`
>
> Optional note from the editor
>
> **issue\_number** `integer`
>
> Sequential number for the issue; if omitted, the next available number is used
>
> **publication\_id** `string` *required*
>
> The numeric ID of the publication where the draft issue will be created. Obtain this from the List Publications action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Collected Link
>
> **Slug:** `CURATED_CREATE_LINK`
>
> Tool to create a collected link for a publication. Use when you want to add a new link (with URL, title, etc.) to a publication's collection.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> URL for the collected link
>
> **image** `string`
>
> Optional image URL for the collected link
>
> **title** `string`
>
> Optional title of the collected link
>
> **category** `string`
>
> Optional category for the collected link, e.g., 'code'
>
> **description** `string`
>
> Optional description for the collected link
>
> **publication\_id** `integer` *required*
>
> ID of the publication to which the link will be added
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Categories
>
> **Slug:** `CURATED_LIST_CATEGORIES`
>
> Tool to list all categories for a publication. Use after you have the publication ID and need to fetch its categories.
>
> #### Input Parameters
>
> **publication\_id** `string` *required*
>
> The numeric ID of the publication (as a string) for which to retrieve categories. Use the 'List Publications' action first to get a list of available publication IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Email Subscribers
>
> **Slug:** `CURATED_LIST_EMAIL_SUBSCRIBERS`
>
> Lists a page of email subscribers for a publication, with pagination support.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to return. Starts at 1 (default: 1).
>
> **per\_page** `integer`
>
> Number of subscribers per page. Valid range: 1-500 (default: 100).
>
> **publication\_id** `string` *required*
>
> The unique ID of the publication whose subscribers are being listed. Obtain this ID by calling the List Publications action first.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Issues
>
> **Slug:** `CURATED_LIST_ISSUES`
>
> Lists a page of newsletter issues for a Curated publication. Filter by published or draft state, optionally include open and click rates, and control pagination with a page size of up to 250. Obtain the publication ID from the List Publications action.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed). Defaults to 1 if not specified.
>
> **state** `string ("published" | "draft")`
>
> Filter issues by state: 'published' returns only published issues, 'draft' returns only draft issues. If omitted, returns all issues.
>
> **stats** `boolean`
>
> If set to true, results will include open and click rates for issues.
>
> **per\_page** `integer`
>
> Number of results per page. Defaults to 10, maximum is 250.
>
> **publication\_id** `string` *required*
>
> The numeric ID of the publication for which to list issues. Obtain this from the List Publications action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Publications
>
> **Slug:** `CURATED_LIST_PUBLICATIONS`
>
> Tool to list all publications accessible by the API key. Use when you need to retrieve your publication IDs for further API calls. Example prompt: "List my publications".
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
