unsubscribe_email
Unsubscribe Email
Unsubscribe an email address from a publication. The email will be added to the unsubscriber list and will no longer receive newsletters.
unsubscribe_email
Unsubscribe an email address from a publication. The email will be added to the unsubscriber list and will no longer receive newsletters.
list_publications
Retrieve all publications associated with your Curated account. Returns each publication's ID, name, and subdomain key. Use this to find publication IDs needed for other operations.
subscribe_email
Subscribe an email address to a publication. By default, the subscriber will receive a welcome email and double opt-in settings will be respected. Use the sync option to bypass double opt-in when syncing from another service where the subscriber has already opted in.
list_categories
Retrieve all categories configured for a publication. Each category includes its code (used as identifier when creating/updating links), display name, and whether it is a sponsored category with a per-issue link limit.
delete_draft_issue
Delete a draft newsletter issue. Only draft issues can be deleted; published issues cannot be removed via the API.
list_issues
List newsletter issues for a publication. Filter by published or draft state, include open/click rate statistics, and paginate through results.
update_link
Update a collected link's properties or move it into a draft issue. You can change the URL, title, description, category, or assign it to a draft issue by specifying the issue ID. Set the issue ID to empty to move a link back to collected items.
list_unsubscribers
List email addresses that have unsubscribed from a publication. Supports pagination for large unsubscriber lists.
create_draft_issue
Create a new draft newsletter issue for a publication. The draft is created using the publication's default settings and can then be edited through the Curated web interface.
create_link
Collect a new link for a publication. The link is added to the publication's collected items and can later be moved into a draft issue. You can optionally specify a title, description, image, and category.
delete_link
Delete a collected link from a publication. Removes the link from the collected items permanently.
list_subscribers
List current email subscribers for a publication. Supports pagination to retrieve large subscriber lists.
get_issue
Retrieve full details of a specific newsletter issue including its categories, items (links and text), and optionally open/click rate statistics. Use the issue number (from list issues) or the database ID for drafts.
list_links
Retrieve all collected links for a publication that have not yet been assigned to an issue. Use this to browse your link collection and find links to include in draft issues.
Manage curated email newsletters, including collecting and organizing links, creating draft issues, managing subscribers, and retrieving publication data. List and retrieve publications, create and delete draft issues with categorized content, collect and update links with metadata, subscribe and unsubscribe emails, and retrieve category configurations. Note: issues cannot be published via the API and no webhook events are available.
Common questions about connecting Curated to AI agents with Metorial.