Create and persist a reusable SocialCRM agent from a guarded specialist archetype.
This is a mutating tool. It requires socialcrm.write; OAuth users must have the admin role.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | Team-visible agent name |
archetype |
string | Yes | One of SocialCRM's supported specialist archetypes |
instructions |
string | Yes | Persistent objective, method, guardrails, and output expectations |
brandIds |
string[] | No | Up to 20 company brand UUIDs |
provider |
string | No | claude, openai, or gemini; defaults to claude |
model |
string | No | Model override for the selected provider |
tools |
string[] | No | WebSearch and/or WebFetch |
Supported archetypes are brand_monitor, content_optimizer, tech_manager, market_analyzer, response_coordinator, ai_simulator, strategist, writer, and optimizer.
SocialCRM's tenant-scoped brand repository and analytics tools are enabled automatically. The returned agent ID is durable and can be used from later conversations or by another authorized teammate.