# Creators agent documentation

Version: 2026-09-18.2

> Contacts, email, and social tools for one connected workspace. Start with the task guide, then read the exact tool schema. Documentation is not live account state.

MCP: https://mcp.creator.gg/mcp
Search: https://docs.creator.gg/search?q=unsubscribe
Catalogue: https://docs.creator.gg/index.json
Full text: https://docs.creator.gg/llms-full.txt

## guides

- [Start here](https://docs.creator.gg/guides/start.md): Discover capabilities, retrieve task guidance, and choose the next supported action.
- [Create, send, and inspect an email campaign](https://docs.creator.gg/guides/email.md): Prepare sender evidence, audience, template, draft, footer, preview, send/schedule, and verify delivery.
- [Email content, merge fields, and unsubscribe footers](https://docs.creator.gg/guides/email-content.md): Exact unsubscribe syntax, automatic-footer behavior, personalization, sender metadata, and rendering limits.
- [Workspace capabilities and readiness](https://docs.creator.gg/guides/readiness.md): Separate connection, feature access, sender/domain evidence, account setup, and delivery proof.
- [Contacts, audiences, and complete pagination](https://docs.creator.gg/guides/contacts.md): Search, preserve preferences, resolve tag IDs, and prepare complete audiences.
- [Social drafts, media, scheduling, and statistics](https://docs.creator.gg/guides/social.md): Discover capabilities and satisfy network-specific posting requirements.
- [Timezones and scheduling](https://docs.creator.gg/guides/scheduling.md): Use explicit instants and IANA zones, frozen audiences, and verify scheduled outcomes.
- [Errors, request IDs, and uncertain outcomes](https://docs.creator.gg/guides/recovery.md): Avoid duplicate writes; distinguish retained receipts, current state, failures, and handoffs.

## tools

- [workspace_status](https://docs.creator.gg/tools/workspace_status.md): Check account readiness, connected capabilities, and human setup links.
- [contacts_search](https://docs.creator.gg/tools/contacts_search.md): Search this account's contacts. Returns one page; repeat with the next page to continue.
- [contacts_get](https://docs.creator.gg/tools/contacts_get.md): Read a contact, including existing fields, tags, and contact preferences.
- [contacts_upsert](https://docs.creator.gg/tools/contacts_upsert.md): Create or update by email or phone using the account's deduplication settings. Preserves tags and DND. Reuse the same requestId when retrying an uncertain operation.
- [contacts_update](https://docs.creator.gg/tools/contacts_update.md): Update provided contact fields only. Use dedicated tag tools to change tags. Reuse the same requestId when retrying an uncertain operation.
- [contacts_delete](https://docs.creator.gg/tools/contacts_delete.md): Delete a contact and associated CRM data; also stops their campaigns/workflows. Requires explicit deletion intent. Reuse the same requestId when retrying an uncertain operation.
- [contacts_tags_add](https://docs.creator.gg/tools/contacts_tags_add.md): Add existing or new tags to a contact without replacing their other tags. Reuse the same requestId when retrying an uncertain operation.
- [contacts_tags_remove](https://docs.creator.gg/tools/contacts_tags_remove.md): Remove only the specified tags from a contact. Reuse the same requestId when retrying an uncertain operation.
- [contacts_suppress_email](https://docs.creator.gg/tools/contacts_suppress_email.md): Suppress future email for this contact. Never re-enables email or clears unsubscribe preferences. Reuse the same requestId when retrying an uncertain operation.
- [contacts_fields_list](https://docs.creator.gg/tools/contacts_fields_list.md): List configured contact custom fields before setting their values.
- [contacts_import_export](https://docs.creator.gg/tools/contacts_import_export.md): Get the native contacts screen for CSV import/export and duplicate merging.
- [audiences_list](https://docs.creator.gg/tools/audiences_list.md): List named tag audiences for this workspace. Email recipients use tag IDs; contact membership tools use tag names.
- [audiences_create](https://docs.creator.gg/tools/audiences_create.md): Create a named tag audience; add/remove members with contact tag tools. Reuse the same requestId when retrying an uncertain operation.
- [audiences_rename](https://docs.creator.gg/tools/audiences_rename.md): Rename an existing tag audience. Reuse the same requestId when retrying an uncertain operation.
- [audiences_delete](https://docs.creator.gg/tools/audiences_delete.md): Delete a tag audience, removing the tag without deleting its contacts. Reuse the same requestId when retrying an uncertain operation.
- [audiences_smart_lists](https://docs.creator.gg/tools/audiences_smart_lists.md): Get the account Smart Lists screen for dynamic saved audiences; this tool does not create or edit them.
- [email_templates_list](https://docs.creator.gg/tools/email_templates_list.md): List reusable email templates or folders. Use include=all to discover folders, then folderId to browse their contents. Follow offset pagination; folders are not templates.
- [email_templates_get](https://docs.creator.gg/tools/email_templates_get.md): Read template metadata and content URL. Visual-builder content is edited in the native UI.
- [email_templates_create](https://docs.creator.gg/tools/email_templates_create.md): Create a reusable HTML or plain-text email template. Reuse the same requestId when retrying an uncertain operation.
- [email_templates_update](https://docs.creator.gg/tools/email_templates_update.md): Update a template. Supply both editorType and editorContent to replace content. Reuse the same requestId when retrying an uncertain operation.
- [email_templates_delete](https://docs.creator.gg/tools/email_templates_delete.md): Delete a reusable email template. Reuse the same requestId when retrying an uncertain operation.
- [email_campaigns_list](https://docs.creator.gg/tools/email_campaigns_list.md): List native email campaigns and authoritative statuses.
- [email_campaigns_get](https://docs.creator.gg/tools/email_campaigns_get.md): Read a campaign's current state, content URL, and statistics source ID.
- [email_campaigns_create](https://docs.creator.gg/tools/email_campaigns_create.md): Create an HTML/plain-text campaign draft, optionally from a template. Reuse the same requestId when retrying an uncertain operation.
- [email_campaigns_update](https://docs.creator.gg/tools/email_campaigns_update.md): Edit a draft campaign. Scheduled or sent campaigns require native controls. Reuse the same requestId when retrying an uncertain operation.
- [email_campaigns_delete](https://docs.creator.gg/tools/email_campaigns_delete.md): Delete a draft campaign only. This is not a cancellation operation. Reuse the same requestId when retrying an uncertain operation.
- [email_campaigns_send](https://docs.creator.gg/tools/email_campaigns_send.md): Send a draft email campaign immediately to the specified audience. Omit From fields to use the authenticated user. This incurs native account usage. Reuse the same requestId when retrying an uncertain operation.
- [email_campaigns_schedule](https://docs.creator.gg/tools/email_campaigns_schedule.md): Schedule a draft email campaign. Omitted From fields use the authenticated user at submission. Recipient membership is frozen at scheduling; acceptance is not delivery. Reuse the same requestId when retrying an uncertain operation.
- [email_campaigns_stats](https://docs.creator.gg/tools/email_campaigns_stats.md): Read native campaign delivery, click, reply, bounce, and unsubscribe statistics.
- [email_campaigns_test](https://docs.creator.gg/tools/email_campaigns_test.md): Get the native campaign screen for a true test send without campaign statistics.
- [email_campaigns_cancel](https://docs.creator.gg/tools/email_campaigns_cancel.md): Get native pause/cancel controls; there is no supported public cancellation endpoint.
- [social_accounts_list](https://docs.creator.gg/tools/social_accounts_list.md): Read connected social accounts and per-account posting/statistics capabilities.
- [social_posts_list](https://docs.creator.gg/tools/social_posts_list.md): List draft/scheduled/published posts over a date range.
- [social_posts_get](https://docs.creator.gg/tools/social_posts_get.md): Read the authoritative status and outcome of a social post.
- [social_posts_create](https://docs.creator.gg/tools/social_posts_create.md): Create a social draft for selected connected accounts. Does not publish. Reuse the same requestId when retrying an uncertain operation.
- [social_posts_update](https://docs.creator.gg/tools/social_posts_update.md): Replace a social draft's text/media/account selection. Read it before editing. Reuse the same requestId when retrying an uncertain operation.
- [social_posts_publish](https://docs.creator.gg/tools/social_posts_publish.md): Publish an existing social draft. Inspect the post to confirm publication after processing. Reuse the same requestId when retrying an uncertain operation.
- [social_posts_schedule](https://docs.creator.gg/tools/social_posts_schedule.md): Schedule or reschedule an existing social draft or scheduled post. Reuse the same requestId when retrying an uncertain operation.
- [social_posts_delete](https://docs.creator.gg/tools/social_posts_delete.md): Delete a draft or cancel a scheduled social post; never deletes a published native post. Reuse the same requestId when retrying an uncertain operation.
- [social_stats](https://docs.creator.gg/tools/social_stats.md): Read supported account statistics. LinkedIn Pages and TikTok Business only; X stats unavailable.
- [social_connections](https://docs.creator.gg/tools/social_connections.md): Get the native Social Planner screen to connect or reconnect accounts.
- [media_list](https://docs.creator.gg/tools/media_list.md): List workspace media assets for social posts and emails.
- [media_import](https://docs.creator.gg/tools/media_import.md): Import a public HTTPS asset URL into the workspace media library. Local-file upload is not supported. Reuse the same requestId when retrying an uncertain operation.
- [documentation_search](https://docs.creator.gg/tools/documentation_search.md): Search Creators documentation for workflow guidance, unsubscribe/footer behavior, sender readiness, tool arguments, limits, errors and recovery. Returns document IDs, relevant excerpts and URLs; read a match with documentation_get. No live workspace data.
- [documentation_get](https://docs.creator.gg/tools/documentation_get.md): Read Creators documentation by ID returned from documentation_search (for example guides/email-content or tools/email_campaigns_send). Returns a bounded line range, section index, version and nextLine. Follow nextLine for remaining content. No live workspace data.
