Everything technical in one place: how assistants and your own code authenticate, how to call the server directly, the named prompts and every tool with its parameters. Setting up Claude or ChatGPT? The main docs have the steps.
Call the MCP endpoint over HTTP with your API key. Start with initialize, then tools/list to see every tool and its input schema.
curl -X POST https://readerradius.com/api/mcp \
-H "Authorization: Bearer aa_sk_..." \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}'curl -X POST https://readerradius.com/api/mcp \
-H "Authorization: Bearer aa_sk_..." \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'Five ready-made prompts run the Reader Radius publisher playbook in your assistant. Each one hands your assistant the playbook first.
Plan 30 days of book marketing for a launch, then schedule week one once you approve.
Arguments: title, launch_date (optional)
Review the last seven days and what's scheduled, then plan and schedule next week.
Last week's results in under 200 words, with up to three suggested changes.
Readers comment a keyword and get your free download by DM. The rule starts paused.
Arguments: magnet_name, download_link
Keep, watch or pause each Amazon campaign, based on the last 14 days.
The playbook itself is the resource readerradius://playbook, and aa_get_playbook returns the same text for assistants that don't load resources. aa_whats_next checks your account and suggests what to do next.
ChatGPT may not show these prompts. If you don't see them, paste the starter prompt instead.
388 tools in all, 377 of them on the MCP plan. Each area links to its tools below.
Every tool your assistant can call, generated from the live server: 388 tools in 18 groups.
ReadsAddsChanges or removesSpends moneydashboard plan
388 tools.
The author's next steps in Reader Radius, worked out from their account: no connected accounts, no Instagram for trial reels, nothing scheduled in the next 7 days, nothing posted in the last 7,…
Ask your assistant: “What should I do next with my book marketing?”
The Reader Radius publisher playbook as markdown: how to plan and run book marketing here (trial reels, vertical shorts, 30 days of posts, lead magnets by DM), with example prompts.
Ask your assistant: “Read the Reader Radius playbook, then plan my launch.”
List the user's connected social media accounts for a given pen-name profile.
Ask your assistant: “List my connected accounts.”
Create and schedule a social media post.
Ask your assistant: “Post this image to Instagram and Facebook tomorrow at 9am with a caption about my new release.”
Update a scheduled post's content or time.
Ask your assistant: “Move Friday's post to Saturday at 10am.”
List the user's posts with optional filters.
Ask your assistant: “Show me everything scheduled for next week.”
List the user's posting queues (queue definitions, not next-slot previews: use aa_queue_preview for that).
Ask your assistant: “What posting slots do I have set up?”
Preview upcoming queue slots for a pen-name profile.
Ask your assistant: “When will my next three queued posts go out?”
Cross-platform post analytics for a pen-name profile (impressions, reach, engagement, etc., per post).
Ask your assistant: “How did my posts do last week? Show reach and engagement by platform.”
List comments on published posts across connected accounts (e.g., people commenting on your Instagram, Facebook or TikTok posts).
Ask your assistant: “Show me new comments on my last three posts.”
Reply to a comment on one of the user's published posts.
Ask your assistant: “Reply to that comment and thank them for reading.”
List DM / messaging conversations across connected accounts.
Ask your assistant: “Do I have any unanswered DMs?”
Create a comment-automation rule (comment or Instagram story-reply keyword → automatic DM).
Ask your assistant: “When someone comments READ, DM them my free chapter.”
List the user's comment-automation rules (e.g., 'auto-DM anyone who comments BOOK on this post').
Ask your assistant: “Which comment-to-DM rules are running?”
Create a new campaign for a pen-name profile.
Ask your assistant: “Plan a 30-day launch campaign for my new book.”
Normalized campaign list across EVERY connected ad network in one call.
Ask your assistant: “How are all my ads doing this month?”
Create a brand-new ad (not boosting an existing post).
Ask your assistant: “Create a $10 a day Meta ad for my book, paused, so I can check it first.”
Pause or resume a paid ad campaign.
Ask your assistant: “Pause the ads that aren't getting clicks.”
Per-campaign Amazon Ads rollups (spend, sales, clicks, impressions, ACOS) over a date window.
Ask your assistant: “Show my Amazon campaigns with spend and ACOS for the last 14 days.”
Ad-attributed Amazon P&L over a date window: spend vs attributed sales/royalties rolled up from the synced Amazon reports.
Ask your assistant: “Are my Amazon ads profitable once page reads are counted?”
Create an Amazon Sponsored Products campaign for a book: campaign, ad group, product ad (the book's ASIN), optional manual keywords, and optional negative keywords (exact/phrase terms the ad must…
Ask your assistant: “Create a $10 a day Sponsored Products campaign for my paperback with automatic targeting, and leave it paused for me to check.”
Show a connected Shopify store (name, domain, currency) and its permissions.
Ask your assistant: “Is my Shopify store connected, and what can Reader Radius do with it?”
The Reader Radius publisher playbook as markdown: how to plan and run book marketing here (trial reels, vertical shorts, 30 days of posts, lead magnets by DM), with example prompts.
The author's next steps in Reader Radius, worked out from their account: no connected accounts, no Instagram for trial reels, nothing scheduled in the next 7 days, nothing posted in the last 7,…
Create an account group.
Delete an account group.
Delete a persona entirely (all four guide texts disappear).
Live health check for ONE account: token validity, needsReconnect, canPost.
Per-account diagnostic health: token validity, granted vs missing OAuth scopes, canFetchAnalytics, and recommendations[].
Get AI provider connection flags and account defaults for text, images, video, and music.
Get the Facebook Page IDs currently attached to the active pen name (these are the pages the user has opted in for posting / insights).
Get a persona: the brand voice the AI uses when writing for a given pen-name profile.
List the pen name's account groups.
List the user's connected social media accounts for a given pen-name profile.
List the Facebook Pages a connected Facebook account can publish to.
List every persona configured for a pen-name profile.
List LinkedIn organizations (Company Pages) the connected LinkedIn user administers.
List every pen-name profile the user has access to.
Move a connected social account to another pen-name profile.
Rename a persona in-place.
Replace the Facebook Page attachment set for the active pen name.
Change which Facebook Page a connected Facebook account publishes to.
Switch a connected LinkedIn account between posting as the personal profile or as an organization (Company Page).
Rename a connected social account (username and/or display name: whatever the platform allows to be changed via API).
Rename an account group and/or replace its member accountIds (the array you pass REPLACES the membership: send the full desired set).
Configure the shared Pollinations account and AI defaults.
Upsert one or more guide texts under a persona tag.
Archive a post: snapshots it into archived_posts (recoverable history) and removes it from the active calendar.
Bulk operate on multiple scheduled posts in one call.
Bookmark a tweet via a connected Twitter/X account.
Check a list of hashtags for Instagram restrictions (banned, shadowbanned, or otherwise flagged) before using them in a post.
Create a calendar note.
Create a new post label.
Create and schedule a social media post.
Permanently delete an archived post snapshot.
Delete a calendar note.
Delete a label.
Delete a SCHEDULED post.
Duplicate a post: creates an unscheduled draft copy of an existing scheduled or published post, so the user can change it and then schedule or post it.
Search the user's books and ingested RSS items for content to repurpose into posts.
Follow a Twitter/X user via a connected account.
Fetch one archived post snapshot by id.
List posts that the reconciler flagged as 'deleted on the platform': rows AA knew about that disappeared from the network.
Get the labels attached to one post.
Per-platform publish-attempt history for one post: why it failed, retries, HTTP status, timestamps.
Day-by-day engagement (impressions, reach, likes, comments, shares, saves, clicks, views) for ONE post across its platform legs.
Fetch a subreddit's feed (or the connected account's home feed if subreddit is omitted) via a connected Reddit account.
TikTok creator settings (privacy-level options, duet/stitch/comment defaults, max video duration).
Fetch a timestamped transcript for a public YouTube video: useful for summarizing or repurposing video content into other posts.
List archived post snapshots for the active pen name, newest first.
List the user's calendar notes: non-publishing annotations (campaign milestones, launch reminders, content themes) that appear on the calendar view.
List the user's post labels (color-coded tags they attach to posts for organization / filtering).
List the user's posts with optional filters.
List playlists on a connected YouTube channel.
Reconcile ONE post against the network: single-post equivalent of aa_refresh_posts.
Force an on-demand reconcile of the active pen name's posts from the network into the local mirror.
Remove a bookmarked tweet via a connected Twitter/X account.
Resolve a LinkedIn person or organization profile URL into the URN + ready-to-use mention format for embedding an @mention in a LinkedIn post.
Restore an archived post: recreates it as a DRAFT (publishNow=false, no scheduledFor) so the user can edit and reschedule before it goes live.
Retry a failed post.
Retweet a tweet via a connected Twitter/X account.
Search Reddit posts via a connected Reddit account's read access.
Set the default Pinterest board a connected account posts to when no boardId is specified on a post.
Set the default subreddit a connected Reddit account posts to when no subreddit is specified.
Replace the labels attached to a post.
Shorten a URL through the user's connected link shortener: for tracked links inside captions (book sales pages, signup forms).
Undo a previous retweet via a connected Twitter/X account.
Unfollow a Twitter/X user via a connected account.
Unpublish a post that has already gone live: removes it from the platform while keeping the AA record.
Patch a calendar note.
Rename or recolor a label.
Update a scheduled post's content or time.
Update a PUBLISHED post's platform metadata without republishing: currently YouTube only (title, description, tags, visibility on the live video).
Pre-flight a post BEFORE calling aa_create_post.
Full pre-publish dry-run validation against the network's live Tools API: checks content + media + per-platform requirements WITHOUT scheduling anything.
Character count for a piece of text against every platform's caption limit: quick check before deciding whether to trim.
Check whether a subreddit accepts a given post type, requires a flair, or has other posting restrictions.
Create a posting queue.
Delete a queue.
Resolve the NEXT open queue slot without scheduling anything: use it to tell the user exactly when 'add to queue' would publish.
List the user's posting queues (queue definitions, not next-slot previews: use aa_queue_preview for that).
Preview upcoming queue slots for a pen-name profile.
Update an existing queue.
Create a new campaign for a pen-name profile.
Write (or rewrite) the captions for a campaign's posts, keyed by post id then platform, using the campaign's themes, the images' visual direction, the pen name's guides and the book.
Paint the campaign's ONE look-check sample image before any plan exists: built from the batch's working look (image_style_capsule), the book (title, synopsis, genre; the cover for product_mockups)…
List campaign posts that are still unscheduled: draft / ready / failed campaign posts joined to their parent campaign.
List the user's campaigns.
Save the content plan to a campaign.
Schedule all the campaign's ready posts.
Update fields on an existing campaign (name, objective, platforms, media_kind, objective_kind, variety, carousel settings incl. carousel_recipes + carousel_image_strategy, book reference selection…
Save a labeled reference document to a book's library.
Bulk operate on multiple Media Studio assets in one call.
Switch a campaign post back to publishing as a slide deck, discarding the video and cancelling any build still running.
Turn one carousel campaign post into a single video (each slide held for a few seconds, optional generated background music) instead of a slide deck.
Check the carousel-to-video build for one campaign post.
Check the progress of media generation for a campaign.
Create a folder in the pen name's shared Media Studio library.
Remove one document from a book's reference library (ids from aa_list_book_reference_docs).
Delete a Media Studio folder.
Delete one Media Studio asset from the library (does not touch posts that already used its URL).
Download a public post's media (video/images) from another creator's post via the network's Tools API: useful for repurposing/reacting to content.
Replace the media (and optionally caption / scheduledAt) on a SCHEDULED or DRAFT post.
Kick off image/video generation for a campaign's posts.
Register an already-uploaded file in the Media Studio library so it sits beside generations and can be offered as a reference image or video start frame.
List a book's reference library.
List folders in the pen name's shared Media Studio library.
List the pen name's Media Studio library: generations AND imported uploads, newest first, 120 per page; pass nextCursor from the previous result to page.
List the tags in use on the pen name's Media Studio library with usage counts, most-used first.
Mark or unmark a Media Studio asset as a saved REFERENCE: named references are offered as style anchors (referenceUrls) in future generations.
Generate standalone media in the Media Studio: images, video, or audio NOT tied to a campaign (for that use aa_generate_media).
Copy or move assets between the user's pen names.
Update a Media Studio asset's organization metadata.
Get a signed URL for uploading media to durable storage.
Check a media URL's dimensions/codec/size against a platform's requirements before posting.
Fetch a single activity-log entry by id (from aa_list_activity_logs).
Cross-platform post analytics for a pen-name profile (impressions, reach, engagement, etc., per post).
Recommended posting times derived from historical engagement.
Content-decay analysis: how quickly the pen name's posts stop earning engagement after publishing, useful for deciding repost/recycle cadence.
Daily time-series metrics across platforms: useful for charting follower / engagement growth.
Facebook Page-level insights (page reach, impressions, engaged users, fan adds, etc.) for ONE Facebook account.
Follower counts and growth across the pen name's connected accounts.
Instagram account-level reach/views/engagement insights for a connected account.
Instagram follower demographics (age / gender / location split) for a connected Instagram account.
LinkedIn analytics for a connected account.
Reactions breakdown (like/celebrate/support/etc.) for a LinkedIn organization post.
Posting-frequency analysis for the pen name's connected accounts: how often posts go out per platform over time, for spotting gaps versus the intended cadence.
Plan name, uploads/profiles used vs. limit, and next billing-anchor reset day.
Day-by-day view counts for a connected YouTube channel.
YouTube viewer age/gender/country demographic split for a connected channel.
Unified activity log across your accounts: publishing, connections, webhooks, messaging events.
Archive or reactivate an inbox DM conversation thread.
Delete a sent DM message from a conversation.
Remove all Instagram DM ice-breaker prompts from a connected Instagram account.
Remove the Messenger persistent menu from an account.
Edit an already-sent DM message: TELEGRAM ONLY (other platforms don't allow edits).
Load full message history for one DM thread.
Get the Instagram DM ice-breaker prompts (up to 4 quick-reply questions shown to new DM conversations) on a connected Instagram account.
Get the Facebook Messenger persistent menu configured for one connected account.
Hide (or unhide) a comment on one of the user's published posts.
Like (or unlike) a comment from the inbox.
List comments on published posts across connected accounts (e.g., people commenting on your Instagram, Facebook or TikTok posts).
List DM / messaging conversations across connected accounts.
List incoming reviews / ratings on connected accounts (e.g., Facebook Page reviews, Google Business reviews).
Pin (or unpin) a top-level comment to the top of a post's comment thread.
Reply to a PUBLIC comment with a PRIVATE DM (Facebook / Instagram only.
Add (or remove) an emoji reaction on a DM message: Telegram and WhatsApp.
Reply to a comment on one of the user's published posts.
Reply to a review left on the user's account.
Send a reply in a DM conversation.
Set the Instagram DM ice-breaker prompts on a connected Instagram account.
Set / replace the Messenger persistent menu for one account.
Activate or pause an inbox automation flow.
Activate a draft or paused sequence: enrolled contacts start/resume moving through its steps.
Create a comment-automation rule (comment or Instagram story-reply keyword → automatic DM).
Create an inbox automation flow (free on every plan).
Create a new RSS feed subscription.
Create a multi-step drip sequence (accountId, platform, name, steps[] required).
Delete a comment-automation rule.
Delete an RSS feed subscription.
Delete a sequence: stops all active enrollments.
Duplicate an inbox automation flow into a new DRAFT named 'Copy of <name>' on the same pen name.
Enroll one or more contacts into a sequence.
Recent executions of an inbox automation flow.
Get a sequence's full details including its steps.
List the user's comment-automation rules (e.g., 'auto-DM anyone who comments BOOK on this post').
List the active pen name's inbox automation flows (trigger → condition → action graphs that auto-respond to comments and DMs).
List the items the feed has ingested (history of headlines + linked posts).
List the user's configured RSS feeds.
List a sequence's enrollments with per-contact progress (currentStepIndex, nextStepAt, stepsSent, exitReason).
List drip sequences with enrollment stats.
Pause an active sequence: enrollments stop advancing and resume where they left off on reactivation.
Manually refresh an RSS feed now (don't wait for the next scheduled poll).
Remove one contact from a sequence's active enrollment.
Patch a comment-automation rule: only the fields you pass change.
Update an inbox automation flow: rename, replace the trigger or graph, or change settings.
Patch an RSS feed.
Update a sequence (name, steps, exit conditions).
Add recipients to a DRAFT broadcast.
Import up to 1,000 contacts at once on a single accountId + platform.
Cancel a scheduled or in-progress broadcast.
Clear a custom field's value on a contact (does not delete the field definition).
Create a broadcast DRAFT (accountId, platform, name required).
Create a CRM contact.
Create a custom-field definition.
Delete a DRAFT broadcast.
Permanently delete a contact and all its channels.
Delete a custom-field definition: also clears its value on every contact that had it set.
Get a broadcast's full config + delivery stats.
Fetch one contact and all its messaging channels by id.
List a broadcast's recipients with per-recipient delivery status (pending/sent/delivered/read/failed).
List broadcasts (one-to-many messages sent to a contact segment) with delivery stats.
List the messaging channels (platform + identifier) on one contact.
List CRM contacts (people you can DM on Instagram, Facebook, Telegram, Twitter, Bluesky, Reddit, or WhatsApp).
List custom-field definitions (typed fields you can attach to contacts: text, number, date, boolean, select).
Schedule a broadcast to send at a future scheduledAt (ISO datetime).
Start sending a broadcast immediately.
Set a custom field's value on a contact.
Update a DRAFT broadcast (name/message/template/segmentFilters).
Partially update a contact (name, email, tags, isSubscribed, etc: send only what's changing).
Update a custom field's name and/or options (its type is immutable once created).
Share one connected ad account with another of the user's pen names: { destination, accountId, sharedWithProfileId, ownerProfileId?
End an ad-account share (either the owner or the receiving pen name may).
List ad-account shares touching the active pen name: accounts other pen names shared with it (receiving) and accounts it shared out (giving).
What the active pen name can do with ads right now: whether the ads upgrade is active (and the checkout path if not), every destination (Meta, Amazon, TikTok, ChatGPT, LinkedIn, Google, Pinterest,…
Assign campaigns to a campaign group and/or remove campaigns from it, in one batch (up to 200 refs).
Create a campaign group (a human label that rolls ads up across networks).
List the active pen name's campaign groups.
The goal-to-result view: every campaign group with cross-network spend, reported revenue, ROAS, clicks, CPC, /day budget, per-platform chips, mapped books, member campaigns and a verdict (winning…
Rename a campaign group or change its verdict rules: targetMetric/targetValue (set both, or pass both as null to clear), breakEvenRoas, startedOn.
The generative prompt the look panel will paint this ad draft's sample from: the look in plain words turned into the scene the image model receives.
Search Meta's or LinkedIn's public ad archive to see what similar authors are running.
Google Ads keyword ideas expanded from seed terms.
Adopts a specific version of a plan: stamps it adopted and points the plan at it.
Creates a draft ads strategy plan from a situation brief (workType, genre, catalogDepth, distribution, budgetPosture, compliance flags, and nonFictionPurpose for non-fiction).
Generates a new version of a plan: runs the deterministic house playbook always, and.
Gets one ads strategy plan with all of its versions, each carrying the assembled contract (playbook decisions + creative + provenance).
Lists this pen name's ads strategy plans (draft, adopted, archived) with their situation brief and current version id.
Validates a proposed targeting spec against the live catalog before it's shown to the author.
Buckets a book's real reader reviews into pain points, trigger moments, objections, transformations and ad-ready phrases, plus a 1-5 quality score.
Judge a click test.
Lists this pen name's click-test runs.
Boost an already-published post as a paid ad.
Start an OAuth flow to connect an AD account (Meta / TikTok / LinkedIn / Pinterest / Google Ads) to the active pen name.
Store OpenAI/ChatGPT ads credentials for the active pen name: plumbing connection, not a full OAuth flow.
Create an empty Meta product catalog (commerce) under the ad account's business.
Keep a connected Shopify store synced into a Meta product catalog, so catalog ads show the store's books with their own covers and prices.
Create a Click-to-WhatsApp ad (an ad whose CTA opens a WhatsApp conversation with the user's business number).
Create a Meta lead-generation form.
Create a brand-new ad (not boosting an existing post).
Delete an ad carousel (the underlying library images are NOT deleted).
Delete an ad set (cancels its ads; returns { deleted, adCount }).
Delete a video from the Meta ad account library (numeric Meta video id).
Stop syncing a Shopify store into a Meta catalog.
Draft a full ad campaign for a book.
Generate ad hooks + body copy for a book (the Creative Studio copy pass).
Generate ad IMAGES for a book in the Creative Studio.
Write hook text for the ideas in one ad draft: the line each ad leads with, kept in that idea's own tactic and awareness stage.
Generate a short ad VIDEO for a book.
Get one ad by id.
Performance metrics for one ad: impressions, clicks, spend, conversions over its run.
List the campaign → book-title mappings for the active pen name (which book each ad campaign advertises).
Hierarchical campaign → ad-set → ad view across the user's ad accounts.
'Analyze my ads'.
Daily spend + results points per network across every connected ad account, merged into one flat series: the data behind the all-ads trend chart.
Read one Shopify → Meta catalog sync: runStatus, lastRunStartedAt/lastRunFinishedAt, lastError and item counts.
List the platform ad accounts (act_*) reachable from one connected social account.
List custom audiences for one ad account.
List the business centers reachable from a connected ad account (TikTok Business Center hierarchy).
List the user's ad campaigns across connected ad accounts.
List the pen name's ad carousels.
List the product sets in one Meta catalog (id, name, productCount).
List the Meta product catalogs a Meta ad account's business owns (id, name, productCount).
List generated ad creatives (images + videos) in the active pen name's creative library, newest first, including generation status and the shared included-tier allowance ({ used, limit } per day).
List the Meta ad account's VIDEO LIBRARY (previously-uploaded ad videos).
List ads across the user's connected ad accounts.
Normalized campaign list across EVERY connected ad network in one call.
List a connected Shopify store's syncs into Meta product catalogs: runStatus (pending, running, succeeded, failed), last run times, lastError, and counts (itemsSent, itemsSkipped = not on the…
List Meta lead-generation forms available on an ad account.
Deterministic ads performance engine.
Start a full sync of the Shopify store into its Meta catalog now.
Create or update an ad carousel.
Search the targeting-interests catalog (e.g., look up 'cozy mystery' to find Meta's interest id for ad targeting).
Search the ad platform's full targeting catalog.
Map one ad campaign to a book title (or clear the mapping).
Pause or resume a paid ad campaign.
Update the brand identity (custom display name and/or avatar) shown on a connected TikTok-ads account's ads.
Upload a standalone video to the Meta ad account library for reuse across ads.
Register an image or video with Amazon's creative assets so a Sponsored Brands or Sponsored Display ad can show it.
Registered Amazon brands an advertiser profile can advertise under, and that brand's logo images when brandId is given.
Enable (start), pause or archive one Amazon campaign from inside the app: the in-app twin of the Start/Pause button, no Amazon console needed.
Per-campaign Amazon Ads rollups (spend, sales, clicks, impressions, ACOS) over a date window.
Create an Amazon Sponsored Brands campaign for a pen name's books.
Create an Amazon Sponsored Display campaign for one book.
Ad-attributed Amazon P&L over a date window: spend vs attributed sales/royalties rolled up from the synced Amazon reports.
Amazon Ads connection status for the active pen name.
Trigger a fresh Amazon Ads report sync for the active pen name's connection.
Create an Amazon Sponsored Products campaign for a book: campaign, ad group, product ad (the book's ASIN), optional manual keywords, and optional negative keywords (exact/phrase terms the ad must…
Amazon Attribution for the pen name: whether any Amazon advertiser profile is enrolled, and the last 30 days of attributed purchases, sales, Kindle Unlimited pages read (KENP) and estimated KENP…
Fetch the author's bridge page (the link's bridge_url, or url) and report what it does: which pixels are on it (Meta, TikTok, Pinterest, LinkedIn, Tag Manager, Google, X), whether it forwards, how…
Read the active pen name's tracking setup: wizard position, per-destination pixel/tag state (created / verified / skipped, server events, event match quality), and every link the ads send people…
Click counts for the pen name's short links (from the link shortener), keyed by destination link id: clicks, the pixels attached to each short link, and whether deep linking is on.
Add a destination link for the pen name's ads: label + https url (kind and retailer are detected; pass kind to override), optional book_id, is_primary, bridge_mode (none | planned | live) +…
Remove a destination link from the pen name's tracking setup (the short link itself, if any, stays live).
Create a branded short link for a destination link's tracked URL (the link plus UTM tags; the author's utm_overrides win).
Update one destination link (same fields as aa_ads_tracking_link_create; only the fields you pass change).
List the links the pen name's ads send people to, each classified as own_store, retailer (amazon | kobo | apple | bn | google_play | books2read | other) or signup, with bridge page, short link,…
Record one destination's tracking setup for the pen name: status (not_started | in_progress | ready | skipped), tag_id (the browser pixel code: the `id` from aa_ads_tracking_tags_list) / tag_name…
Create a pixel on a connected Meta, ChatGPT, TikTok, LinkedIn, Pinterest or X ads account: { network, accountId, adAccountId, name }; Pinterest also takes automaticMatchingFields.
List the pixels / tracking tags on one connected ads account for Meta, ChatGPT, TikTok, LinkedIn, Pinterest or X (optionally scoped by adAccountId).
Update the pen name's tracking profile: wizard_step (1-7), expected_daily_spend, primary_goal, completed_at / skipped_at, amazon_attribution_status.
Is the pixel working?
Create a pixel (tracking tag) on one connected ads account: Meta, ChatGPT, TikTok, LinkedIn, Pinterest or X.
Create a conversion event (purchase, lead, add to cart...) on one tracking tag so ads can measure and optimize toward it.
Remove a conversion event from a tracking tag.
Is this pixel live on the author's Shopify store?
Install a pixel on the author's connected Shopify store in one click (storefront and checkout, no theme edits): the store then reports page views, product views, add to cart, checkout and…
List the conversion destinations (pixels / datasets) available on a connected ad account.
List the conversion events on one tracking tag (Google conversion actions, LinkedIn conversion rules, Meta custom conversions, TikTok pixel events, Pinterest custom events, X web events, ChatGPT…
List the pixels / tracking tags on one connected ads account (Meta, ChatGPT, TikTok, LinkedIn, Pinterest, X, Google).
Take a pixel off the author's Shopify store.
Send server-side conversion events (purchases, sign-ups, …) to a connected ad account's conversion destination so its ads optimize on real outcomes.
Update one tracking tag on an ads account: { tagId } plus any of name, enableAutomaticMatching, automaticMatchingFields, firstPartyCookieStatus, dataUseSetting.
Update one conversion event on a tracking tag (at least one field).
Connect a Shopify store to the active pen name with a merchant-created custom-app Admin API token (shpat_…): the no-OAuth path.
Publish (or draft/schedule) an article on a Shopify blog.
Create a collection on the author's Shopify store, optionally with products already in it (product ids from aa_list_shopify_products).
Create a discount on the author's Shopify store.
Create a product on the author's Shopify store.
Delete a Shopify blog article permanently.
Show on-hand stock for one Shopify product, per variant and location.
Get one Shopify product with its variants (variant ids are needed for aa_update_shopify_product_prices), images, status and storefront URL.
List articles on one Shopify blog (blogId from aa_list_shopify_blogs).
List the blogs on a connected Shopify store (accountId from aa_list_accounts, platform shopify).
List a Shopify store's sales channels (id, name), e.g. Online Store.
List collections on a connected Shopify store (e.g. one per series).
List discounts on a connected Shopify store (codes and automatic).
List a Shopify store's stock locations.
List products on a connected Shopify store.
Publish a Shopify product to sales channels, or take it off them (channel ids from aa_list_shopify_channels).
Turn a Shopify discount on or off without deleting it.
Change stock for a Shopify product's variants.
Activate, deactivate, archive or DELETE up to 50 Shopify products in one call; answers which succeeded and which failed.
Show a connected Shopify store (name, domain, currency) and its permissions.
Update a Shopify blog article: only the fields you pass change.
Add products to, or remove them from, a Shopify collection.
Update a Shopify product's details; only the fields you pass change (tags replaces the whole list).
Set prices on a Shopify product's variants (variant ids from aa_get_shopify_product).
Add up to 8 phone numbers (E.164 format) to a WhatsApp group per call.
Approve pending join requests on a WhatsApp group.
Create a WhatsApp Flow (multi-screen native form) as a DRAFT.
Create a WhatsApp group.
Create a WhatsApp message template: either CUSTOM (goes to Meta review, PENDING → APPROVED/REJECTED, up to 24h) or LIBRARY (pre-approved, no wait).
Delete a DRAFT WhatsApp Flow.
Delete a WhatsApp group and remove all participants.
Permanently delete a WhatsApp message template.
Deprecate a PUBLISHED WhatsApp Flow: stops new sends; in-flight conversations finish normally.
Get a WhatsApp Business profile (about, address, description, email, websites, vertical, picture).
Get a WhatsApp Business account's current display name + Meta review status.
Get a WhatsApp Flow's details + preview URL.
Fetch a WhatsApp Flow's JSON definition + a temporary download URL.
Get a WhatsApp group's info: subject, description, participants, settings.
Poll a WhatsApp phone number's provisioning status (pending_payment/provisioning/active/suspended/releasing/released).
Get one WhatsApp message template by name.
List WhatsApp Flows (DRAFT/PUBLISHED/DEPRECATED/BLOCKED/THROTTLED) on a connected account.
List pending join requests on a WhatsApp group (only meaningful when joinApprovalMode is 'approval_required').
List active WhatsApp groups on a connected account.
List this pen name's WhatsApp phone numbers (workspace-level, workspace-provisioned).
List WhatsApp message templates on a connected WhatsApp Business account.
IRREVERSIBLE: publish a DRAFT WhatsApp Flow.
Buy a WhatsApp phone number (Telnyx + Meta pre-verification, payment-first, plan-dependent max count).
Reject pending join requests on a WhatsApp group.
Release a WhatsApp phone number: disconnects the WhatsApp account, decrements the subscription, and releases the number from Telnyx.
Remove phone numbers (E.164 format) from a WhatsApp group.
Request a WhatsApp Business display-name change.
Rotate a WhatsApp group's invite link.
Send a published (or draft, with draft:true) WhatsApp Flow as an interactive message.
Partial update of a WhatsApp Business profile: only the fields you send change.
Update a DRAFT WhatsApp Flow's name and/or categories.
Update a WhatsApp group's subject, description, and/or joinApprovalMode ('approval_required' or 'auto_approve').
Update an APPROVED WhatsApp template's components.
Upload/replace a DRAFT WhatsApp Flow's JSON (screens + components: see Meta's Flow JSON reference).
Connect a Telegram channel/group to the active pen name via the bot-code flow: no token pasting needed.
Remove the bot commands menu from a connected Telegram account.
Get the bot commands (the / menu users see) configured on a connected Telegram account.
Set the bot commands menu on a connected Telegram account.
Assign which Google Business Profile location a connected Google Business account posts to.
Fetch Google Business Profile reviews across multiple locations in one call.
Add a place action (booking/ordering link) to a Google Business Profile location.
Delete a photo/video from a Google Business Profile location.
Remove a place action from a Google Business Profile location by its resource name.
Get a Google Business Profile location's attributes (amenities, accessibility, etc).
Get a Google Business Profile location's food menu (labels, sections, items with price/dietary/allergen info).
Get a Google Business Profile location's details (name, address, hours, categories, phone, etc).
Get a Google Business Profile location's service list.
Google Business Profile performance metrics (calls, direction requests, website clicks, impressions) by day for a connected GBP location.
Top search queries that surfaced a Google Business Profile listing.
List the Google Business Profile locations available on a connected Google Business account (a business can have many locations; posting targets exactly one).
List photos/videos on a Google Business Profile location.
List place actions (booking/ordering links) on a Google Business Profile location.
List Google Business Profile reviews (with any owner replies) for a connected GBP account.
REPLACE the ENTIRE service list on a Google Business Profile location: Google requires full-list replacement, not partial updates.
Update a Google Business Profile location's attributes.
Replace a Google Business Profile location's food menu.
Update a Google Business Profile location's details.
Update a place action on a Google Business Profile location by its resource name (from aa_list_gmb_place_actions).
Upload a photo/video to a Google Business Profile location from a public URL.
Get a connected Discord account's webhook identity (display name / avatar) and currently connected channel.
List Discord channels available to a connected Discord account's webhook (text, announcement, and forum channels).
Change a connected Discord account's webhook identity and/or switch which channel it posts to (same guild only).