MMetadata /docs
⌘K
Docs/Tools/set_default_ma_list

set_default_ma_list

Set the account's default marketing automation (MA) destination list.

Writes other

Creates or changes something in the account. Put it behind whatever review your agent uses.

What it does

Set the account's default marketing automation (MA) destination list.

                    USAGE INSTRUCTIONS FOR LLM:
                    WARNING: requires a concrete, resolved list_id. You MUST call search_ma_lists
                    first and pass the exact "listId" of the match the user confirmed. Never invent
                    or guess a list_id.

                    The default is a SNAPSHOT source, not a live link: newly-created eligible campaign
                    channels (not CTR goal, not Reddit) copy this value once at creation time. Setting
                    a new default has no effect on channels already created, and duplicating a campaign
                    always preserves the source channel's own value instead of consulting the default.

                    WHEN TO USE THIS TOOL:
                    - User wants to set or change the default marketing automation destination list
                    - After search_ma_lists returns the list the user wants

                    RESPONSE FORMAT:
                    On success, returns the same shape as get_default_ma_list with status AVAILABLE.
                    On failure, "status" is one of:
                    - VALIDATION_FAILED: the list_id was not found in the connected MA tool
                    - PERMISSION_DENIED: the caller lacks marketing-automation write access
                    - DISCONNECTED: no marketing automation tool is connected to this account
                    Each failure includes a "message" explaining why.

                    EXAMPLE: "Set the default MA list to the one you just found" -> set_default_ma_list(list_id=12345)

Arguments

ArgumentTypeNotes
list_id integer required A concrete list id already resolved via search_ma_lists. Never invent or guess one.

Request

Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_default_ma_list","arguments":{"list_id":0}}}'

Response

No recorded response. This tool writes to the account, so it is never executed to build these docs. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other other tools:

Browse the tool catalog · machine-readable index