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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Curated connection
In AgentKit > Connections, create a Curated connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'curated'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'curated_publications_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "curated"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="curated_publications_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolcurated_categories_listList the content categories of a publication.Read-onlyList 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-onlyGet 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-onlyList 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-onlyList 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-onlyGet 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-onlyList 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.
curated_link_getGet one collected link.Read-onlyGet Link
Get one collected link. Returns the collected link's record. Use curated_links_list to find link IDs.
Inputs
link_idstringrequired- ID of the collected link, from curated_links_list. Example: 123456.
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
curated_links_listList the collected links of a publication that are not yet in an issue.Read-onlyList Collected Links
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.
Inputs
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
curated_publications_listList the Curated publications (newsletters) the API key's account can access.Read-onlyList Publications
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.
Inputs
This tool takes no inputs.
curated_email_subscriber_createSubscribe an email address to a publication.WriteSubscribe Email
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.
Inputs
emailstringrequired- Email address to subscribe. Example: reader@example.com.
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
syncboolean- Set to true to skip the publication's double opt-in, for people who already opted in elsewhere. Default false. Example: false.
curated_issue_draft_createCreate a new draft issue with the publication's default settings.WriteCreate Draft Issue
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.
Inputs
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
curated_link_createAdd a link to a publication's collected items, ready to include in an issue.WriteCollect Link
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.
Inputs
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
urlstringrequired- URL of the page to collect. Example: https://example.com/article.
categorystring- Category code for the link, from curated_categories_list. Example: news.
descriptionstring- Description of the link (Markdown). Example: A practical write-up on caching and parallel builds.
imagestring- URL of an image to upload for the link. Example: https://example.com/cover.jpg.
titlestring- Title of the link. Leave empty to let Curated fetch it. Example: How we cut our build time in half.
curated_link_updateUpdate a collected link, or move it into or out of a draft issue.WriteUpdate Link
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).
- Idempotent
Inputs
link_idstringrequired- ID of the collected link, from curated_links_list. Example: 123456.
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
categorystring- New category code, from curated_categories_list. Example: tools.
descriptionstring- New description (Markdown). Example: Updated with new benchmarks.
issue_idstring- id of a draft issue to move the link into, from curated_issues_list. Example: 98765.
titlestring- New title. Example: How we cut our build time by 60%.
urlstring- New URL for the link. Example: https://example.com/article-v2.
curated_email_unsubscribeUnsubscribe an email address from a publication.DestructiveUnsubscribe Email
Unsubscribe an email address from a publication. Returns the result of the unsubscribe. Use curated_email_subscriber_create to subscribe someone again.
Inputs
emailstringrequired- Email address to unsubscribe. Example: reader@example.com.
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
curated_issue_draft_deletePermanently delete a draft issue.DestructiveDelete Draft Issue
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.
- Idempotent
Inputs
issue_idstringrequired- id of the draft issue (not its number), from curated_issues_list. Example: 98765.
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
curated_link_deletePermanently delete a collected link.DestructiveDelete Link
Permanently delete a collected link. Returns a confirmation. Use curated_links_list to find link IDs.
- Idempotent
Inputs
link_idstringrequired- ID of the collected link to delete, from curated_links_list. Example: 123456.
publication_idstringrequired- ID of the publication, from curated_publications_list. Example: 4513.
No tools match.