Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Curated

Scalekit connector
Open markdown

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.

Tools
16
What they doRead · write · destructive
9 · 4 · 39 read4 write3 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

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

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Curated credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • curated_categories_listList the content categories of a publication.Read-only

    List Categories

    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.

    Inputs

    publication_idstringrequired
    ID of the publication, from curated_publications_list. Example: 4513.
  • curated_email_subscriber_getGet one email subscriber of a publication.Read-only

    Get Email Subscriber

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

    Inputs

    publication_idstringrequired
    ID of the publication, from curated_publications_list. Example: 4513.
    subscriber_idstringrequired
    ID of the email subscriber. Example: 778899.
  • curated_email_subscribers_listList a publication's email subscribers, one page at a time.Read-only

    List Email Subscribers

    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.

    Inputs

    publication_idstringrequired
    ID of the publication, from curated_publications_list. Example: 4513.
    pageinteger
    Page number to return, starting at 1. Example: 1.
    per_pageinteger
    Results per page. Default 100, maximum 500. Example: 50.
  • curated_email_unsubscribers_listList the email addresses that unsubscribed from a publication.Read-only

    List Email Unsubscribers

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

    Inputs

    publication_idstringrequired
    ID of the publication, from curated_publications_list. Example: 4513.
    pageinteger
    Page number to return, starting at 1. Example: 1.
    per_pageinteger
    Results per page. Default 100, maximum 500. Example: 50.
  • curated_issue_getGet the full content of one issue: its categories and their text and link items.Read-only

    Get Issue

    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.

    Inputs

    issue_numberstringrequired
    Issue number from curated_issues_list, or the issue id (required for unpublished drafts). Example: 42.
    publication_idstringrequired
    ID of the publication, from curated_publications_list. Example: 4513.
    statsboolean
    Set to true to include open and click rates and per-link click counts for a published issue. Example: true.
  • curated_issues_listList a publication's issues, newest first, optionally only published or only draft issues.Read-only

    List Issues

    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.

    Inputs

    publication_idstringrequired
    ID of the publication, from curated_publications_list. Example: 4513.
    pageinteger
    Page number to return, starting at 1. Example: 1.
    per_pageinteger
    Results per page. Default 10, maximum 250. Example: 50.
    statestring
    Return only published or only draft issues. Leave empty for both. Example: published.one of publisheddraft
    statsboolean
    Set to true to include open and click rates. Example: true.