# Curated

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

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `CURATED`
- **Version:** 20260223_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Title of the new draft issue |
| `editor_note` | string | No | Optional note from the editor |
| `issue_number` | integer | No | Sequential number for the issue; if omitted, the next available number is used |
| `publication_id` | string | Yes | The numeric ID of the publication where the draft issue will be created. Obtain this from the List Publications action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | URL for the collected link |
| `image` | string | No | Optional image URL for the collected link |
| `title` | string | No | Optional title of the collected link |
| `category` | string | No | Optional category for the collected link, e.g., 'code' |
| `description` | string | No | Optional description for the collected link |
| `publication_id` | integer | Yes | ID of the publication to which the link will be added |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `publication_id` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Email Subscribers

**Slug:** `CURATED_LIST_EMAIL_SUBSCRIBERS`

Tool to list all email subscribers for a publication. Use after confirming the publication ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number of results to return. Starts at 1 (default: 1). |
| `per_page` | integer | No | Number of subscribers per page. Valid range: 1-500 (default: 100). |
| `publication_id` | string | Yes | The unique ID of the publication whose subscribers are being listed. Obtain this ID by calling the List Publications action first. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Issues

**Slug:** `CURATED_LIST_ISSUES`

Lists all issues (newsletters) for a Curated publication with pagination support. Use this tool to retrieve issues from a publication. You must first obtain the publication_id by calling the List Publications action. Supports filtering by state (published/draft) and optionally includes email performance stats (open/click rates).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). Defaults to 1 if not specified. |
| `state` | string ("published" | "draft") | No | Filter issues by state: 'published' returns only published issues, 'draft' returns only draft issues. If omitted, returns all issues. |
| `stats` | boolean | No | If set to true, results will include open and click rates for issues. |
| `per_page` | integer | No | Number of results per page. Defaults to 10, maximum is 250. |
| `publication_id` | string | Yes | The numeric ID of the publication for which to list issues. Obtain this from the List Publications action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |