Tools

REST guide: Email Marketing

• email_get_organization — Any valid key. Organization, scopes, and the email sending allowance.
• email_list_audiences — audiences:read. The lists in this workspace.
• email_create_audience — audiences:write. Creates a list. Fails if the name is taken.
• email_list_contacts — contacts:read. Filter with audienceId, status, or q.
• email_upsert_contact — contacts:write. Creates or updates one contact by email.
• email_list_campaigns — campaigns:read. Newest first.
• email_create_campaign — campaigns:write. Saves a draft. Does not send.
• email_send_campaign — campaigns:write. Mails the audience. Ask before calling.
• email_list_templates — templates:read. Use latestVersionId when creating a campaign.
• email_record_conversion — conversions:write. Records revenue against an email address.

REST guide: Transactional email

• email_list_messages — messages:read. Recent one-to-one sends. Filter with externalId.
• email_send_message — messages:write. Delivers to the addresses in the call. Ask before calling.

REST guide: Post Scheduling

• scheduling_list_accounts — schedule:read. Connected accounts. Use accountId on a target.
• scheduling_list_groups — schedule:read. Draft and scheduled posts.
• scheduling_get_group — schedule:read. One post, including why a target is not ready.
• scheduling_schedule_post — schedule:write. Creates the post and confirms it. This publishes and charges. Ask before calling.
• scheduling_cancel_group — schedule:write. Drops targets that have not published.

REST guide: Knowledge Vault

• knowledge_list_pillars — vault:read. The sections you can fill, with the id to send as pillarId. Offers & pricing is offers.
• knowledge_list_entries — vault:read. Your entries, including the full write-up. No AI tokens.
• knowledge_get_entry — vault:read. One entry by id. No AI tokens.
• knowledge_create_entry — vault:write. Saves an entry in a section and indexes it. Indexing can spend AI tokens.
• knowledge_update_entry — vault:write. Changes the fields you send. A text, tag, or section change re-indexes.
• knowledge_delete_entry — vault:write. Deletes one entry. Ask before calling.
• knowledge_search — vault:read. Answers a question from the vault. Spends AI tokens.

Unified Inbox and Magic Studio have no tools yet. A client that calls a name from an older note, such as inbox_list_threads, receives UNKNOWN_TOOL.