> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Curated

The Curated connector lets your AI agent act in each user's Curated account. Each user connects their own Curated API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 16 tools.

**Authentication:** API Key
**Categories:** Marketing, Communication
**Tools:** 16: 9 read, 4 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CURATED)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Curated connection

   In **AgentKit > Connections**, create a Curated connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'curated'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Curated:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'curated_publications_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "curated"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Curated:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="curated_publications_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Curated credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'curated_categories_list',
  toolInput: {
    publication_id: '<publication_id>',
  },
  connector: 'curated',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="curated_categories_list",
    tool_input={
        "publication_id": "<publication_id>",
    },
    connection_name="curated",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `curated_categories_list`

List Categories · Read-only

List the content categories of a publication.
Returns categories with code, name, sponsored and limit (sponsored links per issue).
Use a category code when creating or updating links with curated_link_create or curated_link_update.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"publication_id":"<publication_id>"}`

### `curated_email_subscriber_get`

Get Email Subscriber · Read-only

Get one email subscriber of a publication.
Returns the subscriber's record.
Use curated_email_subscribers_list to find subscriber IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `subscriber_id` (`string`, required): ID of the email subscriber. Example: 778899.

Example input: `{"publication_id":"<publication_id>","subscriber_id":"<subscriber_id>"}`

### `curated_email_subscribers_list`

List Email Subscribers · Read-only

List a publication's email subscribers, one page at a time.
Returns a page of subscriber records (per_page and page control paging).
Use curated_email_subscriber_get for one subscriber and curated_email_unsubscribers_list for people who left.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1.
- `per_page` (`integer`, optional): Results per page. Default 100, maximum 500. Example: 50.

Example input: `{"publication_id":"<publication_id>"}`

### `curated_email_unsubscribers_list`

List Email Unsubscribers · Read-only

List the email addresses that unsubscribed from a publication.
Returns a page of unsubscribed email records.
Use curated_email_subscribers_list for active subscribers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1.
- `per_page` (`integer`, optional): Results per page. Default 100, maximum 500. Example: 50.

Example input: `{"publication_id":"<publication_id>"}`

### `curated_issue_get`

Get Issue · Read-only

Get the full content of one issue: its categories and their text and link items.
Returns id, number, title, summary, url, published_at, updated_at and categories, each with name, code and items (title, description, url and embedded links).
Use curated_issues_list to find issue numbers. Draft issues are fetched by id instead of number.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `issue_number` (`string`, required): Issue number from curated_issues_list, or the issue id (required for unpublished drafts). Example: 42.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `stats` (`boolean`, optional): Set to true to include open and click rates and per-link click counts for a published issue. Example: true.

Example input: `{"issue_number":"<issue_number>","publication_id":"<publication_id>"}`

### `curated_issues_list`

List Issues · Read-only

List a publication's issues, newest first, optionally only published or only draft issues.
Returns page, total_pages, total_results and issue summaries with number, title, summary, url, published_at and updated_at (plus open and click rates with stats).
Use curated_issue_get for an issue's full content.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1.
- `per_page` (`integer`, optional): Results per page. Default 10, maximum 250. Example: 50.
- `state` (`string`, optional): Return only published or only draft issues. Leave empty for both. Example: published. One of: `published`, `draft`.
- `stats` (`boolean`, optional): Set to true to include open and click rates. Example: true.

Example input: `{"publication_id":"<publication_id>"}`

### `curated_link_get`

Get Link · Read-only

Get one collected link.
Returns the collected link's record.
Use curated_links_list to find link IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `link_id` (`string`, required): ID of the collected link, from curated_links_list. Example: 123456.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"link_id":"<link_id>","publication_id":"<publication_id>"}`

### `curated_links_list`

List Collected Links · Read-only

List the collected links of a publication that are not yet in an issue.
Returns the publication's collected link records, each with its id.
Use this to review the link queue before building an issue. Use curated_link_get for one link.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"publication_id":"<publication_id>"}`

### `curated_publications_list`

List Publications · Read-only

List the Curated publications (newsletters) the API key's account can access.
Returns publications with id, name and key (the Curated subdomain).
Use this first: almost every other Curated tool needs a publication ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `curated_email_subscriber_create`

Subscribe Email · Write

Subscribe an email address to a publication. The subscriber gets the normal welcome email, and double opt-in applies unless sync is true.
Returns success true, or success false with error_message and errors (for example already subscribed).
Only subscribe people who clearly agreed to join the list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email address to subscribe. Example: reader@example.com.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `sync` (`boolean`, optional): Set to true to skip the publication's double opt-in, for people who already opted in elsewhere. Default false. Example: false.

Example input: `{"email":"<email>","publication_id":"<publication_id>"}`

### `curated_issue_draft_create`

Create Draft Issue · Write

Create a new draft issue with the publication's default settings.
Returns the new draft issue, including its id.
Use the id with curated_link_update (issue_id) to move collected links into the draft. Issues are published from the Curated app, not the API.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"publication_id":"<publication_id>"}`

### `curated_link_create`

Collect Link · Write

Add a link to a publication's collected items, ready to include in an issue.
Returns the created link with its id.
Only links can be collected through the API, not text items. Use curated_link_update with issue_id to place it in a draft issue.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `url` (`string`, required): URL of the page to collect. Example: https://example.com/article.
- `category` (`string`, optional): Category code for the link, from curated_categories_list. Example: news.
- `description` (`string`, optional): Description of the link (Markdown). Example: A practical write-up on caching and parallel builds.
- `image` (`string`, optional): URL of an image to upload for the link. Example: https://example.com/cover.jpg.
- `title` (`string`, optional): Title of the link. Leave empty to let Curated fetch it. Example: How we cut our build time in half.

Example input: `{"publication_id":"<publication_id>","url":"<url>"}`

### `curated_link_update`

Update Link · Write

Update a collected link, or move it into or out of a draft issue. Links in published issues cannot be changed.
Returns the updated link.
Set issue_id to a draft issue's id to move the link there (it then leaves the collected items).

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `link_id` (`string`, required): ID of the collected link, from curated_links_list. Example: 123456.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.
- `category` (`string`, optional): New category code, from curated_categories_list. Example: tools.
- `description` (`string`, optional): New description (Markdown). Example: Updated with new benchmarks.
- `issue_id` (`string`, optional): id of a draft issue to move the link into, from curated_issues_list. Example: 98765.
- `title` (`string`, optional): New title. Example: How we cut our build time by 60%.
- `url` (`string`, optional): New URL for the link. Example: https://example.com/article-v2.

Example input: `{"link_id":"<link_id>","publication_id":"<publication_id>"}`

### `curated_email_unsubscribe`

Unsubscribe Email · Destructive

Unsubscribe an email address from a publication.
Returns the result of the unsubscribe.
Use curated_email_subscriber_create to subscribe someone again.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email address to unsubscribe. Example: reader@example.com.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"email":"<email>","publication_id":"<publication_id>"}`

### `curated_issue_draft_delete`

Delete Draft Issue · Destructive

Permanently delete a draft issue. Published issues cannot be deleted.
Returns a confirmation.
Use curated_issues_list with state draft to find draft issue ids.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `issue_id` (`string`, required): id of the draft issue (not its number), from curated_issues_list. Example: 98765.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"issue_id":"<issue_id>","publication_id":"<publication_id>"}`

### `curated_link_delete`

Delete Link · Destructive

Permanently delete a collected link.
Returns a confirmation.
Use curated_links_list to find link IDs.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `link_id` (`string`, required): ID of the collected link to delete, from curated_links_list. Example: 123456.
- `publication_id` (`string`, required): ID of the publication, from curated_publications_list. Example: 4513.

Example input: `{"link_id":"<link_id>","publication_id":"<publication_id>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
